structure WSANAMESPACE_INFOW (winsock2.h)

Article
11/20/2024

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

Syntaxe

typedef struct _WSANAMESPACE_INFOW {
  GUID   NSProviderId;
  DWORD  dwNameSpace;
  BOOL   fActive;
  DWORD  dwVersion;
  LPWSTR lpszIdentifier;
} WSANAMESPACE_INFOW, *PWSANAMESPACE_INFOW, *LPWSANAMESPACE_INFOW;

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. Les valeurs possibles suivantes sont donc 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 DNS (Domain Name System).
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 TRUE, indique que ce fournisseur d’espaces de noms est actif. Si FAUX, le fournisseur d’espaces de noms est inactif et n’est pas accessible pour les requêtes, même si la requête référence spécifiquement ce fournisseur d’espaces de noms.

dwVersion

Type : DWORD

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

lpszIdentifier

Type : LPTSTR

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

Remarques

La structure WSANAMESPACE_INFO est utilisée par les fonctions WSAEnumNameSpaceProviders et WSCEnumNameSpaceProviders32 pour retourner des informations sur les fournisseurs d’espaces de noms disponibles. La structure WSANAMESPACE_INFO contient les informations spécifiques au fournisseur sur l’entrée d’espace de noms transmise au WSCInstallNameSpace et fonctions WSCInstallNameSpace32 lors de l’installation du fournisseur d’espaces de noms.

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

Lorsque UNICODE ou _UNICODE n’est pas défini, WSANAMESPACE_INFO est défini sur WSANAMESPACE_INFOA, la version ANSI de cette structure de données et le membre de chaîne lpszIdentifier est défini sur le type de données LPSTR.

Sur Windows Vista et versions ultérieures, WSANAMESPACE_INFOEX, une version améliorée de la structure WSANAMESPACE_INFO, est retournée par des appels aux fonctions WSAEnumNameSpaceProvidersEx et WSCEnumNameSpaceProvidersEx32

Note

L’en-tête winsock2.h définit WSANAMESPACE_INFO 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. Le mélange 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.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
serveur minimum pris en charge	Windows 2000 Server [applications de bureau uniquement]
d’en-tête	winsock2.h