structure WSANAMESPACE_INFOW (winsock2.h)

Article
08/27/2023

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’espace 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 de reconnaissance de l’emplacement réseau (NLA). 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’espace 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’espace 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 aux fonctions WSCInstallNameSpace et WSCInstallNameSpace32 lors de l’installation du fournisseur d’espaces de noms.

Lorsque unicode ou _UNICODE est défini, WSANAMESPACE_INFO est défini pour 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 pour WSANAMESPACE_INFOA, la version ANSI de cette structure de données et le membre de chaîne lpszIdentifier sont définis 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

Notes

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

Configuration requise

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