Broker 10.5 | webMethods Broker Documentation | webMethods Broker Client C API Programmer's Guide | API Reference | awGet | 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.
See also: