WSANAMESPACE_INFOEXW Structure

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

Syntax

typedef struct _WSANAMESPACE_INFOEXW {
    GUID NSProviderId;
    DWORD dwNameSpace;
    BOOL fActive;
    DWORD dwVersion;
    LPWSTR lpszIdentifier;
    BLOB ProviderSpecific;
} WSANAMESPACE_INFOEXW, *PWSANAMESPACE_INFOEXW, *LPWSANAMESPACE_INFOEXW;  

Members

NSProviderId
A unique GUID for this namespace provider.

dwNameSpace

The namespace supported by this provider.

fActive
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
The version number of the namespace provider.

lpszIdentifier
A display string that identifies the namespace provider.

ProviderSpecific
A provider-specific data blob associated with namespace entry.

Remarks

The WSANAMESPACE_INFOEX structure is an enhanced version of the WSANAMESPACE_INFO structure that is used by the WSAEnumNameSpaceProvidersEx and the WSCEnumNameSpaceProvidersEx32 functions to return information on available namespace providers. The WSANAMESPACE_INFOEX structure contains the provider-specific data blob associated with the namespace entry passed in the lpProviderInfo parameter to the WSCInstallNameSpaceEx and WSCInstallNameSpaceEx32 functions.

Currently, the only namespace included with Windows that uses information in the ProviderSpecific member of the WSANAMESPACE_INFOEX structure are namespace providers for the NS_EMAIL namespace. The format of the ProviderSpecific member for an NS_EMAIL namespace provider is a NAPI_PROVIDER_INSTALLATION_BLOB structure.

When UNICODE or _UNICODE is defined, WSANAMESPACE_INFOEX is defined to WSANAMESPACE_INFOEXW, the Unicode version of this structure and the lpszIdentifier string member is defined to the LPWSTR data type.

When UNICODE or _UNICODE is not defined, WSANAMESPACE_INFOEX is defined to WSANAMESPACE_INFOEXA, the ANSI version of this structure and the lpszIdentifier string member is defined to the LPSTR data type.

The WSCEnumNameSpaceProvidersEx32 function is a Unicode only function and returns WSANAMESPACE_INFOEXW structures.

Requirements

Header: Declared in winsock2.h.

Library: Use ws2_32.lib.