WSAEnumNameSpaceProviders
The Windows
Sockets WSAEnumNameSpaceProviders function retrieves information about
available name spaces.
INT WSAAPI WSAEnumNameSpaceProviders (
LPDWORD lpdwBufferLength, |
|
LPWSANAMESPACE_INFO lpnspBuffer |
|
); |
|
Parameters
lpdwBufferLength
[in/out] On
input, the number of bytes contained in the buffer pointed to by lpnspBuffer.
On output (if the function fails, and the error is WSAEFAULT), the minimum
number of bytes to pass for the lpnspBuffer to retrieve all the
requested information. The passed-in buffer must be sufficient to hold all of
the name space information.
lpnspBuffer
[out] A
buffer which is filled with WSANAMESPACE_INFO123VBFO structuresdescribed below. The returned
structures are located consecutively at the head of the buffer. Variable sized
information referenced by pointers in the structures point to locations within
the buffer located between the end of the fixed sized structures and the end of
the buffer. The number of structures filled in is the return value of WSAEnumNameSpaceProviders.
Return Values
WSAEnumNameSpaceProviders returns the number of WSANAMESPACE_INFO
Error Codes
WSAEFAULT |
the buffer
length was too small to receive all the relevant WSANAMESPACE_INFO
structures and associated information. Pass in a buffer at least as large as
the value returned in lpdwBufferLength. |
WSANOTINITIALIZED |
The Windows
Sockets 2 DLL has not been initialized. The application must first call WSAStartup
before calling any Windows Sockets functions. |