WSANAMESPACE_INFOEXA structure (winsock2.h)
La structure WSANAMESPACE_INFOEX contient toutes les informations d’inscription d’un fournisseur d’espaces de noms.
Syntaxe
typedef struct _WSANAMESPACE_INFOEXA {
GUID NSProviderId;
DWORD dwNameSpace;
BOOL fActive;
DWORD dwVersion;
LPSTR lpszIdentifier;
BLOB ProviderSpecific;
} WSANAMESPACE_INFOEXA, *PWSANAMESPACE_INFOEXA, *LPWSANAMESPACE_INFOEXA;
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.
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 |