Initiates the use of Winsock with an NLM handle.
#include <winsock/ws2ext.h>
int WSPAPI WSAStartupWithNLMHandle (
WORD wVersionRequested,
LPWSADATA lpWSAData,
void *nlmHandle);
(IN) Specifies the highest version of Windows sockets support that the caller can use. The high-order byte specifies the minor version (revision) number; the low-order byte specifies the major version number.
(IN/OUT) Points to the WSADATA structure that receives the details of the Windows sockets implementation.
(IN) Points to the NLM handle of the application to be associated with this instance of Winsock.
If successful, returns 0. Otherwise, returns -1 and sets errno to one of the following:
The WSAStartupWithNLMHandle function has the equivalent functionality as the standard Winsock function WSAStartup, except it allows the application to designate the NLM Handle to be associated with the startup call. When WSAStartup is called on NetWare, the NLM handle of the calling process is associated with the session and all subsequent calls into Winsock must be from that NLM. In the case of a library which initializes Winsock for a calling application, library needs to register the NLM handle of the calling application, so the application can later use the Winsock calls directly.