Skip to content

Latest commit

 

History

History
234 lines (166 loc) · 8.29 KB

ns-winsock2-wsanamespace_infoexa.md

File metadata and controls

234 lines (166 loc) · 8.29 KB
UID title description helpviewer_keywords old-location tech.root ms.assetid ms.date ms.keywords req.header req.include-header req.target-type req.target-min-winverclnt req.target-min-winversvr req.kmdf-ver req.umdf-ver req.ddi-compliance req.unicode-ansi req.idl req.max-support req.namespace req.assembly req.type-library req.lib req.dll req.irql targetos req.typenames req.redist ms.custom f1_keywords dev_langs topic_type api_type api_location api_name
NS:winsock2._WSANAMESPACE_INFOEXA
WSANAMESPACE_INFOEXA (winsock2.h)
Contains all registration information for a namespace provider. (WSANAMESPACE_INFOEXA)
*LPWSANAMESPACE_INFOEXA
*PWSANAMESPACE_INFOEXA
LPWSANAMESPACE_INFOEX
LPWSANAMESPACE_INFOEX structure pointer [Winsock]
NS_BTH
NS_DNS
NS_EMAIL
NS_NLA
NS_NTDS
NS_PNRPCLOUD
NS_PNRPNAME
PWSANAMESPACE_INFOEX
PWSANAMESPACE_INFOEX structure pointer [Winsock]
WSANAMESPACE_INFOEX
WSANAMESPACE_INFOEX structure [Winsock]
WSANAMESPACE_INFOEXA
WSANAMESPACE_INFOEXW
winsock.wsanamespace_infoex
winsock2/LPWSANAMESPACE_INFOEX
winsock2/PWSANAMESPACE_INFOEX
winsock2/WSANAMESPACE_INFOEX
winsock2/WSANAMESPACE_INFOEXA
winsock2/WSANAMESPACE_INFOEXW
winsock\wsanamespace_infoex.htm
WinSock
3f4a8916-9db9-4b65-982f-4cb4ec2205ed
12/05/2018
*LPWSANAMESPACE_INFOEXA, *PWSANAMESPACE_INFOEXA, LPWSANAMESPACE_INFOEX, LPWSANAMESPACE_INFOEX structure pointer [Winsock], NS_BTH, NS_DNS, NS_EMAIL, NS_NLA, NS_NTDS, NS_PNRPCLOUD, NS_PNRPNAME, PWSANAMESPACE_INFOEX, PWSANAMESPACE_INFOEX structure pointer [Winsock], WSANAMESPACE_INFOEX, WSANAMESPACE_INFOEX structure [Winsock], WSANAMESPACE_INFOEXA, WSANAMESPACE_INFOEXW, winsock.wsanamespace_infoex, winsock2/LPWSANAMESPACE_INFOEX, winsock2/PWSANAMESPACE_INFOEX, winsock2/WSANAMESPACE_INFOEX, winsock2/WSANAMESPACE_INFOEXA, winsock2/WSANAMESPACE_INFOEXW
winsock2.h
Windows
Windows Vista [desktop apps only]
Windows Server 2008 [desktop apps only]
WSANAMESPACE_INFOEXW (Unicode) and WSANAMESPACE_INFOEXA (ANSI)
Windows
WSANAMESPACE_INFOEXA, *PWSANAMESPACE_INFOEXA, *LPWSANAMESPACE_INFOEXA
19H1
_WSANAMESPACE_INFOEXA
winsock2/_WSANAMESPACE_INFOEXA
PWSANAMESPACE_INFOEXA
winsock2/PWSANAMESPACE_INFOEXA
WSANAMESPACE_INFOEXA
winsock2/WSANAMESPACE_INFOEXA
c++
APIRef
kbSyntax
HeaderDef
Winsock2.h
WSANAMESPACE_INFOEX
WSANAMESPACE_INFOEXA
WSANAMESPACE_INFOEXW

WSANAMESPACE_INFOEXA structure

-description

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

-struct-fields

-field NSProviderId

Type: GUID

A unique GUID for this namespace provider.

-field 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.

-field 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.

-field dwVersion

Type: DWORD

The version number of the namespace provider.

-field lpszIdentifier

Type: LPTSTR

A display string that identifies the namespace provider.

-field ProviderSpecific

Type: BLOB

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.

Note

The winsock2.h header defines WSANAMESPACE_INFOEX as an alias which 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 not encoding-neutral can lead to mismatches that result in compilation or runtime errors. For more information, see Conventions for Function Prototypes.

-see-also

NAPI_PROVIDER_INSTALLATION_BLOB

WSAEnumNameSpaceProvidersEx

WSANAMESPACE_INFO

WSCEnumNameSpaceProvidersEx32

WSCInstallNameSpaceEx

WSCInstallNameSpaceEx32