DOC HOME SITE MAP MAN PAGES GNU INFO SEARCH PRINT BOOK
 
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