WSANAMESPACE_INFOEXW-Struktur (winsock2.h)
Die WSANAMESPACE_INFOEX-Struktur enthält alle Registrierungsinformationen für einen Namespaceanbieter.
Syntax
typedef struct _WSANAMESPACE_INFOEXW {
GUID NSProviderId;
DWORD dwNameSpace;
BOOL fActive;
DWORD dwVersion;
LPWSTR lpszIdentifier;
BLOB ProviderSpecific;
} WSANAMESPACE_INFOEXW, *PWSANAMESPACE_INFOEXW, *LPWSANAMESPACE_INFOEXW;
Member
NSProviderId
Typ: GUID
Eine eindeutige GUID für diesen Namespaceanbieter.
dwNameSpace
Art: DWORD
Der von diesem Anbieter unterstützte Namespace.
Mögliche Werte für das dwNameSpace-Element sind in der Winsock2.h-Includedatei aufgeführt. In Windows Vista und höher sind mehrere Namespaceanbieter enthalten. Andere Namespaceanbieter können installiert werden, sodass die folgenden möglichen Werte nur die allgemein verfügbaren sind. Viele andere Werte sind möglich.
fActive
Typ: BOOL
Gibt bei TRUE an, dass dieser Namespaceanbieter aktiv ist. Bei FALSE ist der Namespaceanbieter inaktiv und für Abfragen nicht zugänglich, auch wenn die Abfrage speziell auf diesen Namespaceanbieter verweist.
dwVersion
Art: DWORD
Die Versionsnummer des Namespaceanbieters.
lpszIdentifier
Typ: LPTSTR
Eine Anzeigezeichenfolge, die den Namespaceanbieter identifiziert.
ProviderSpecific
Typ: BLOB
Ein anbieterspezifisches Datenblob, das dem Namespaceeintrag zugeordnet ist.
Hinweise
Die WSANAMESPACE_INFOEX-Struktur ist eine erweiterte Version der WSANAMESPACE_INFO-Struktur , die von den Funktionen WSAEnumNameSpaceProvidersEx und WSCEnumNameSpaceProvidersEx32 verwendet wird, um Informationen zu verfügbaren Namespaceanbietern zurückzugeben. Die WSANAMESPACE_INFOEX-Struktur enthält das anbieterspezifische Datenblob, das dem Namespaceeintrag zugeordnet ist, der im lpProviderInfo-Parameter an die Funktionen WSCInstallNameSpaceEx und WSCInstallNameSpaceEx32 übergeben wird.
Derzeit ist der einzige In Windows enthaltene Namespace, der Informationen im ProviderSpecific-Member der WSANAMESPACE_INFOEX-Struktur verwendet, Namespaceanbieter für den NS_EMAIL Namespace. Das Format des ProviderSpecific-Members für einen NS_EMAIL-Namespaceanbieter ist eine NAPI_PROVIDER_INSTALLATION_BLOB-Struktur .
Wenn UNICODE oder _UNICODE definiert ist, wird WSANAMESPACE_INFOEX für WSANAMESPACE_INFOEXW, die Unicode-Version dieser Struktur und der lpszIdentifier-Zeichenfolgenmember für den LPWSTR-Datentyp definiert.
Wenn UNICODE oder _UNICODE nicht definiert ist, wird WSANAMESPACE_INFOEX für WSANAMESPACE_INFOEXA, die ANSI-Version dieser Struktur und der lpszIdentifier-Zeichenfolgenmember für den LPSTR-Datentyp definiert.
Die WSCEnumNameSpaceProvidersEx32-Funktion ist eine reine Unicode-Funktion und gibt WSANAMESPACE_INFOEXW-Strukturen zurück.
Hinweis
Der winsock2.h-Header definiert WSANAMESPACE_INFOEX als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht Codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows Vista [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2008 [nur Desktop-Apps] |
| Kopfzeile | winsock2.h |