Functions and Directives Functions and Directives

Function SocketFDSetNew() Professional

Creates a new descriptor set for sockets.

Syntax
SocketFDSetNew( [@<nError>] ) --> nFDSet
Parameters
<nError>
If this parameter is passed by reference to the function, it gets assigned a numeric error code when the function fails. #define constants beginning with WSAE are available in the file SOCKET.CH to identify an error condition.
Return

The function renurns a numeric handle for the new descriptor set or 0 in case of an error.

Description

If an application uses multiple sockets (multiplexing I/O requests), it may group the sockets in descriptor sets. A descriptor set is similar to an array holding multiple sockets, but is identified via a numeric handle returned from SocketFDSetNew(). This handle must be used for all SocketFD..() functions. Once a new descriptor set is created, sockets are added to it using the function SocketFD_SET(). The readiness of individual sockets contained in the descriptor set to read/write messages is then checked with the SocketSelect() function.

When a descriptor set is no longer needed in an application, its resources must be released by calling the SocketFDSetDelete() function.

Feedback

If you see anything in the documentation that is not correct, does not match your experience with the particular feature or requires further clarification, please use this form to report a documentation issue.