SVR5 and SCO OpenServer 5
GetNextClient(D3pccard)
GetNextClient --
return ClientHandle for next registered client
Synopsis
#include <sys/types.h>
#include <sys/lcs.h>
#include <sys/lss.h>
int CardServices (GetNextClient, ClientHandle_t *h,
int n1, int ClientLen,
GetFirstNextClient_t *pFirstNextClient);
rm_key_t key);
Description
GetNextClient( )
returns the
ClientHandle(D4pccard)
structure for the next registered client.
Arguments
h-
Pointer to a
ClientHandle(D4pccard)
structure.
n1-
NULL
ClientLen-
Length of the
GetFirstNextClient(D4pccard)
structure.
pFirstNextClient-
Pointer to a
GetFirstNextClient(D4pccard)
structure.
key-
Resource manager
key.
Return values
BAD_HANDLE-
Clienthandle is invalid.
BAD_SOCKET-
Socket or function invalid.
NO_MORE_ITEMS-
No clients are registered after the present one.
SUCCESS-
Next registered client returned successfully.
Usage
The
ClientHandle(D4pccard)
strcture that was previously returned by the
GetFirstClient(D3pccard)
or
GetNextClient(D3pccard)
service
is passed into this service.
The next ClientHandle is also returned
by the *h pointer.
If there are no more clients,
CardServices( )
sets the Status argument to NO_MORE_ITEMS.
Unexpected results may occur
if another client performs a successful
RegisterClient(D3pccard)
or
DeregisterClient(D3pccard)
request after the present client
has performed a
GetFirstClient(D3pccard)
or
GetNextClient(D3pccard)
request
and before the present client
makes a subsequent
GetNextClient( )
request.
Context and synchronization
User or initialization
context
Hardware applicability
All
Version applicability
pccard:
1, 2, 3
References
ClientHandle(D4pccard),
GetFirstNextClient(D4pccard)
19 June 2005
© 2005 The SCO Group, Inc. All rights reserved.
OpenServer 6 and UnixWare (SVR5) HDK - June 2005