WSANAMESPACE_INFO structure

The WSANAMESPACE_INFO structure contains all registration information for a namespace provider.

Syntax

typedef struct _WSANAMESPACE_INFO {
  GUID   NSProviderId;
  DWORD  dwNameSpace;
  BOOL   fActive;
  DWORD  dwVersion;
  LPTSTR lpszIdentifier;
} WSANAMESPACE_INFO, *PWSANAMESPACE_INFO;

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.

Value	Meaning
NS_BTH	The Bluetooth namespace. This namespace identifier is supported on Windows Vista and later.
NS_DNS	The domain name system (DNS) namespace.
NS_EMAIL	The email namespace. This namespace identifier is supported on Windows Vista and later.
NS_NLA	The network location awareness (NLA) namespace. This namespace identifier is supported on Windows XP and later.
NS_NTDS	The Windows NT directory service (NTDS) namespace.
NS_PNRPNAME	The peer-to-peer name space for a specific peer name. This namespace identifier is supported on Windows Vista and later.
NS_PNRPCLOUD	The peer-to-peer name space for a collection of peer names. This namespace identifier is supported on Windows Vista and later.

 

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

Requirements

See also

WSAEnumNameSpaceProviders

WSAEnumNameSpaceProvidersEx

WSCEnumNameSpaceProviders32

WSCEnumNameSpaceProvidersEx32

WSANAMESPACE_INFOEX

WSCInstallNameSpace

WSCInstallNameSpace32