WSANAMESPACE_INFOA structure (winsock2.h)
The WSANAMESPACE_INFO structure contains all registration information for a namespace provider.
Syntax
typedef struct _WSANAMESPACE_INFOA {
GUID NSProviderId;
DWORD dwNameSpace;
BOOL fActive;
DWORD dwVersion;
LPSTR lpszIdentifier;
} WSANAMESPACE_INFOA, *PWSANAMESPACE_INFOA, *LPWSANAMESPACE_INFOA;
Members
NSProviderId
Type: GUID
A unique GUID for this namespace provider.
dwNameSpace
Type: DWORD
The namespace supported by this provider.
Possible values for the dwNameSpace member are listed in the Winsock2.h include file. Several namespace providers are included with Windows Vista and later. Other namespace providers can be installed, so the following possible values are only those commonly available. Many other values are possible.
fActive
Type: BOOL
If TRUE, indicates that this namespace provider is active. If FALSE, the namespace provider is inactive and is not accessible for queries, even if the query specifically references this namespace provider.
dwVersion
Type: DWORD
The version number of the namespace provider.
lpszIdentifier
Type: LPTSTR
A display string that identifies the namespace provider.
Remarks
The WSANAMESPACE_INFO structure is used by the WSAEnumNameSpaceProviders and WSCEnumNameSpaceProviders32 functions to return information on available namespace providers. The WSANAMESPACE_INFO structure contains the provider-specific information on the namespace entry passed to the WSCInstallNameSpace and WSCInstallNameSpace32 functions when the namespace provider was installed.
When UNICODE or _UNICODE is defined, WSANAMESPACE_INFO is defined to WSANAMESPACE_INFOW, the Unicode version of this data structure and the lpszIdentifier string member is defined to the LPWSTR data type.
When UNICODE or _UNICODE is not defined, WSANAMESPACE_INFO is defined to WSANAMESPACE_INFOA, the ANSI version of this data structure and the lpszIdentifier string member is defined to the LPSTR data type.
On Windows Vista and later, WSANAMESPACE_INFOEX, an enhanced version of the WSANAMESPACE_INFO structure, is returned by calls to the WSAEnumNameSpaceProvidersEx and WSCEnumNameSpaceProvidersEx32 functions
Note
The winsock2.h header defines WSANAMESPACE_INFO as an alias that automatically selects the ANSI or Unicode version of this function based on the definition of the UNICODE preprocessor constant. Mixing usage of the encoding-neutral alias with code that is not encoding-neutral can lead to mismatches that result in compilation or runtime errors. For more information, see Conventions for Function Prototypes.
Requirements
Requirement | Value |
---|---|
Minimum supported client | Windows 2000 Professional [desktop apps only] |
Minimum supported server | Windows 2000 Server [desktop apps only] |
Header | winsock2.h |