awGetFd

awGetFd

BrokerError awGetFd(
BrokerClient client,
int *fd);

client	The Broker client whose field descriptor is to be returned.
fd	The client's file descriptor. This parameter is used for output.

Provides the file descriptor for the specified client. When data are waiting to be read on the file descriptor, use awIsClientPending to see if an event has arrived. If data have arrived, you may use any of event retrieval functions, such as awGetEvent, or an event dispatching function, such as awDispatch, to handle the event.

Important:
Use of this function in combination with secure sockets is not recommended.

Each client may have a separate file descriptor or they may share a common descriptor. The sample applications subscribe4.c and subscribe5.c provide examples of how to use this function.

Possible BrokerError major codes	Meaning
AW_ERROR_INVALID_CLIENT	The client has been destroyed or disconnected.
AW_ERROR_NULL_PARAM	The parameter fd is NULL.