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

94 lines
5.4 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="CWBSO_DisplayList" />
<meta name="DC.Relation" scheme="URI" content="rzaiksoaapilist.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="cwbso_displaylist" />
<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>CWBSO_DisplayList</title>
</head>
<body id="cwbso_displaylist"><a name="cwbso_displaylist"><!-- --></a>
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
<h1 class="topictitle1"><span class="apiname">CWBSO_DisplayList</span></h1>
<div><div class="section"><h4 class="sectiontitle">Purpose</h4><p>Displays the list in a window. From this
window, the user is allowed to perform actions on the objects in the list.</p>
</div>
<div class="section"><h4 class="sectiontitle">Syntax</h4><pre>
unsigned int CWB_ENTRY CWBSO_DisplayList(
CWBSO_LIST_HANDLE listHandle,
HINSTANCE hInstance,
int nCmdShow,
HWND far* lphWnd ,
CWBSO_ERR_HANDLE errorHandle); </pre>
</div>
<div class="section"><h4 class="sectiontitle">Parameters</h4><dl><dt class="dlterm">CWBSO_LIST_HANDLE listHandle - input</dt>
<dd>A handle to a list that was returned by a previous call to <span class="apiname">CWBSO_CreateListHandle</span> or
<span class="apiname">CWBSO_CreateListHandleEx</span>.</dd>
<dt class="dlterm">HINSTANCE hInstance - input</dt>
<dd>The program instance passed to the calling program's WinMain procedure.</dd>
<dt class="dlterm">int nCmdShow - input</dt>
<dd>The show window parameter passed to the calling program's WinMain procedure.
Alternatively, any of the constants defined for the Windows<sup>®</sup> API <span class="apiname">ShowWindow()</span> may
be used.</dd>
<dt class="dlterm">HWND far* lphWnd - output</dt>
<dd>A long pointer to a window handle. This will be set to the handle of
the window in which the list is displayed.</dd>
<dt class="dlterm">CWBSO_ERR_HANDLE errorHandle - input</dt>
<dd>A handle to an error object. If an error occurs that there is error text
for, this handle may be used to retreive the error message text or display
the error to the user.</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">CWBSO_NO_ERROR</dt>
<dd>No error occurred.</dd>
<dt class="dlterm">CWBSO_BAD_LIST_HANDLE</dt>
<dd>The list handle that is specified is not valid.</dd>
<dt class="dlterm">CWBSO_BAD_ERR_HANDLE</dt>
<dd>The error handle that is specified is not valid.</dd>
<dt class="dlterm">CWBSO_DISPLAY_FAILED</dt>
<dd>The window could not be created.</dd>
<dt class="dlterm">CWBSO_LOW_MEMORY</dt>
<dd>Not enough memory is available for the request.</dd>
<dt class="dlterm">CWBSO_ERROR_OCCURRED</dt>
<dd>An error occurred. Use error handle for more information.</dd>
</dl>
</div>
<div class="section"><h4 class="sectiontitle">Usage</h4><p><span class="apiname">CWBSO_CreateListHandle</span> must
be called prior to calling this API. The list handle that is returned by <span class="apiname">CWBSO_CreateListHandle</span> must
be passed as input to this API. <span class="apiname">CWBSO_CreateErrorHandle</span> must
be called prior to calling this API. The error handle that is returned by <span class="apiname">CWBSO_CreateErrorHandle</span> must
be passed as input to this API. It is not necessary to call <span class="apiname">CWBSO_OpenList</span> or <span class="apiname">CWBSO_CloseList</span> when
using this API. <span class="apiname">CWBSO_DisplayList</span> handles both the opening
and closing of the list. Your program must have a message loop to receive
the Windows messages
that will be sent during the use of the system object list.</p>
<p>This API
only applies to the following list types: Jobs, Messages, Printers, Printer
Output, and Spooled Files.</p>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="rzaiksoaapilist.htm" title="The following System Object Access APIs for iSeries Access for Windows are listed alphabetically.">System Object Access APIs for iSeries Access for Windows List</a></div>
</div>
</div>
</body>
</html>