structure WSANAMESPACE_INFOEXW (winsock2.h)
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. Les valeurs possibles suivantes sont donc uniquement celles couramment disponibles. De nombreuses autres valeurs sont possibles.
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.
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 la WSAEnumNameSpaceProvidersEx et les fonctions 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ée dans le paramètre lpProviderInfo aux fonctions WSCInstallNameSpaceEx et WSCInstallNameSpaceEx32.
Actuellement, le seul espace de noms inclus avec Windows qui utilise des informations dans le ProviderSpecific membre de la structure WSANAMESPACE_INFOEX sont des fournisseurs d’espaces de noms pour l’espace de noms NS_EMAIL’espace de noms. Le format du membre ProviderSpecific
Lorsque unicode ou _UNICODE est défini, WSANAMESPACE_INFOEX est défini sur WSANAMESPACE_INFOEXW, la version Unicode de cette structure et le membre de chaîne lpszIdentifier est défini sur le type de données LPWSTR.
Quand UNICODE ou _UNICODE n’est pas défini, WSANAMESPACE_INFOEX est défini sur WSANAMESPACE_INFOEXA, la version ANSI de cette structure et le membre de chaîne lpszIdentifier est défini sur le type de données LPSTR.
La fonction WSCEnumNameSpaceProvidersEx32 est une fonction Unicode uniquement et retourne WSANAMESPACE_INFOEXW structures.
Note
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. 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 Vista [applications de bureau uniquement] |
| serveur minimum pris en charge | Windows Server 2008 [applications de bureau uniquement] |
| d’en-tête | winsock2.h |