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)