| INT WINAPI InetGetClientThreads( |
| |
SOCKET hServer |
|
| ); |
Returns the number of client session threads created by the server.
Parameters
- hServer
- Handle to the server socket.
Return Value
If the function succeeds, the return value is the number of client
session threads that have been created by the server. If the function fails, the return value is
INET_ERROR. To
get extended error information, call InetGetLastError.
Remarks
The InetGetClientThreads function returns the number of
threads that are managing client sessions for the specified server. If
there are no clients connected to the server, this function will
return a value of zero. Because this function returns the number of
session threads, the value returned will include those clients that
are in the process of disconnecting from the server but their session
thread has not yet terminated. This differs from the
InetEnumServerClients function which will only enumerate active
clients.
If you wish to determine when the last client has disconnected from
the server, call this function within an event handler for the
INET_EVENT_DISCONNECT event. If the function returns a value greater
than one, then there are other client sessions that are either
connected or in the process of terminating.
Requirements
Minimum Desktop Platform: Windows 7 (Service Pack 1)
Minimum Server Platform: Windows Server 2008 R2 (Service Pack 1)
Header: Include cswsock10.h
Import Library: cswskv10.lib
See Also
InetEnumServerClients,
InetEnumServerClientsByAddress
|