ibm-information-center/dist/eclipse/plugins/i5OS.ic.rzaik_5.4.0.1/rzaikcwbsvcreateerrhandle.htm

66 lines
3.2 KiB
HTML

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html
PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html lang="en-us" xml:lang="en-us">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<meta name="security" content="public" />
<meta name="Robots" content="index,follow" />
<meta http-equiv="PICS-Label" content='(PICS-1.1 "http://www.icra.org/ratingsv02.html" l gen true r (cz 1 lz 1 nz 1 oz 1 vz 1) "http://www.rsac.org/ratingsv01.html" l gen true r (n 0 s 0 v 0 l 0) "http://www.classify.org/safesurf/" l gen true r (SS~~000 1))' />
<meta name="DC.Type" content="reference" />
<meta name="DC.Title" content="cwbSV_CreateErrHandle" />
<meta name="DC.Relation" scheme="URI" content="rzaiksvcapilist5.htm" />
<meta name="copyright" content="(C) Copyright IBM Corporation 1999, 2006" />
<meta name="DC.Rights.Owner" content="(C) Copyright IBM Corporation 1999, 2006" />
<meta name="DC.Format" content="XHTML" />
<meta name="DC.Identifier" content="cwbsv_createerrhandle" />
<meta name="DC.Language" content="en-us" />
<!-- All rights reserved. Licensed Materials Property of IBM -->
<!-- US Government Users Restricted Rights -->
<!-- Use, duplication or disclosure restricted by -->
<!-- GSA ADP Schedule Contract with IBM Corp. -->
<link rel="stylesheet" type="text/css" href="./ibmdita.css" />
<link rel="stylesheet" type="text/css" href="./ic.css" />
<title>cwbSV_CreateErrHandle</title>
</head>
<body id="cwbsv_createerrhandle"><a name="cwbsv_createerrhandle"><!-- --></a>
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
<h1 class="topictitle1">cwbSV_CreateErrHandle</h1>
<div><div class="section"><h4 class="sectiontitle">Purpose</h4>
<p>This function creates an error message object and returns a handle to it.
This error handle can be passed to @@xe1s@@ APIs that support it. If an error
occurs on one of these APIs, the error handle can be used to retrieve the
error messages text that is associated with the API error.</p>
</div>
<div class="section"><h4 class="sectiontitle">Syntax</h4>
<pre>
unsigned int CWB_ENTRY cwbSV_CreateErrHandle(
cwbSV_ErrHandle *errorHandle);</pre>
</div>
<div class="section"><h4 class="sectiontitle">Parameters</h4>
<dl><dt class="dlterm">cwbSV_ErrHandle *errorHandle - input/output</dt>
<dd>Pointer to a cwbSV_ErrHandle where the handle will be returned.</dd>
</dl>
</div>
<div class="section"><h4 class="sectiontitle">Return Codes</h4>
<p>The following list shows common return values.</p>
<dl><dt class="dlterm">CWB_OK</dt>
<dd>Successful completion.</dd>
<dt class="dlterm">CWB_INVALID_POINTER</dt>
<dd>NULL passed as handle address.</dd>
<dt class="dlterm">CWB_NOT_ENOUGH_MEMORY</dt>
<dd>Insufficient memory to create handle.</dd>
</dl>
</div>
<div class="section"><h4 class="sectiontitle">Usage</h4>
<p>None</p>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="rzaiksvcapilist5.htm" title="Use these APIs to retrieve message text associated with error handles">Serviceability API list: Retrieving message text</a></div>
</div>
</div>
</body>
</html>