WSANAMESPACE_INFOEXW structure (winsock2.h)

Article
08/27/2023

La structure WSANAMESPACE_INFOEX contient toutes les informations d’inscription d’un fournisseur d’espaces de noms.

Syntaxe

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

Membres

NSProviderId

Type : GUID

GUID unique pour ce fournisseur d’espaces de noms.

dwNameSpace

Type : DWORD

Espace de noms pris en charge par ce fournisseur.

Les valeurs possibles pour le membre dwNameSpace sont répertoriées dans le fichier Include Winsock2.h . Plusieurs fournisseurs d’espaces de noms sont inclus dans Windows Vista et versions ultérieures. D’autres fournisseurs d’espaces de noms peuvent être installés, de sorte que les valeurs possibles suivantes sont uniquement celles couramment disponibles. De nombreuses autres valeurs sont possibles.

Valeur	Signification
NS_BTH	Espace de noms Bluetooth. Cet identificateur d’espace de noms est pris en charge sur Windows Vista et versions ultérieures.
NS_DNS	Espace de noms de domaine (DNS).
NS_EMAIL	Espace de noms d’e-mail. Cet identificateur d’espace de noms est pris en charge sur Windows Vista et versions ultérieures.
NS_NLA	Espace de noms NLA (Network Location Awareness). Cet identificateur d’espace de noms est pris en charge sur Windows XP et versions ultérieures.
NS_NTDS	Espace de noms du service d’annuaire Windows NT (NTDS).
NS_PNRPNAME	Espace de nom d’égal à égal pour un nom d’homologue spécifique. Cet identificateur d’espace de noms est pris en charge sur Windows Vista et versions ultérieures.
NS_PNRPCLOUD	Espace de nom d’égal à égal pour une collection de noms d’homologues. Cet identificateur d’espace de noms est pris en charge sur Windows Vista et versions ultérieures.

fActive

Type : BOOL

Si la valeur est TRUE, indique que ce fournisseur d’espace de noms est actif. Si la valeur est FALSE, le fournisseur d’espaces de noms est inactif et n’est pas accessible pour les requêtes, même si la requête fait spécifiquement référence à ce fournisseur d’espaces de noms.

dwVersion

Type : DWORD

Numéro de version du fournisseur d’espace de noms.

lpszIdentifier

Type : LPTSTR

Chaîne d’affichage qui identifie le fournisseur d’espaces de noms.

ProviderSpecific

Type : BLOB

Objet blob de données spécifique au fournisseur associé à l’entrée d’espace de noms.

Remarques

La structure WSANAMESPACE_INFOEX est une version améliorée de la structure WSANAMESPACE_INFO utilisée par les fonctions WSAEnumNameSpaceProvidersEx et WSCEnumNameSpaceProvidersEx32 pour retourner des informations sur les fournisseurs d’espaces de noms disponibles. La structure WSANAMESPACE_INFOEX contient l’objet blob de données spécifique au fournisseur associé à l’entrée d’espace de noms passé dans le paramètre lpProviderInfo aux fonctions WSCInstallNameSpaceEx et WSCInstallNameSpaceEx32 .

Actuellement, le seul espace de noms inclus dans Windows qui utilise des informations dans le membre ProviderSpecific de la structure WSANAMESPACE_INFOEX sont des fournisseurs d’espaces de noms pour l’espace de noms NS_EMAIL. Le format du membre ProviderSpecific pour un fournisseur d’espaces de noms NS_EMAIL est une structure NAPI_PROVIDER_INSTALLATION_BLOB .

Lorsque unicode ou _UNICODE est défini, WSANAMESPACE_INFOEX est défini pour WSANAMESPACE_INFOEXW, la version Unicode de cette structure et le membre de chaîne lpszIdentifier sont définis sur le type de données LPWSTR .

Lorsque unicode ou _UNICODE n’est pas défini, WSANAMESPACE_INFOEX est défini pour WSANAMESPACE_INFOEXA, la version ANSI de cette structure et le membre de chaîne lpszIdentifier sont définis sur le type de données LPSTR .

La fonction WSCEnumNameSpaceProvidersEx32 est une fonction Unicode uniquement et retourne WSANAMESPACE_INFOEXW structures.

Notes

L’en-tête winsock2.h définit WSANAMESPACE_INFOEX en tant qu’alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. La combinaison de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau uniquement]
En-tête	winsock2.h