WSAEnumNameSpaceProvidersExW-Funktion (winsock2.h)
Die WSAEnumNameSpaceProvidersEx--Funktion ruft Informationen zu verfügbaren Namespaceanbietern ab.
Syntax
INT WSAAPI WSAEnumNameSpaceProvidersExW(
[in, out] LPDWORD lpdwBufferLength,
[out] LPWSANAMESPACE_INFOEXW lpnspBuffer
);
Parameter
[in, out] lpdwBufferLength
Bei eingaben die Anzahl der im Puffer enthaltenen Bytes, auf die durch lpnspBufferverwiesen wurde. Bei der Ausgabe (wenn die Funktion fehlschlägt und der Fehler WSAEFAULTist), ist die mindeste Anzahl von Bytes, die für den lpnspBuffer Puffer zugeordnet werden, damit er alle angeforderten Informationen abrufen kann. Der an WSAEnumNameSpaceProvidersEx übergebene Puffer muss ausreichen, um alle Namespaceinformationen zu enthalten.
[out] lpnspBuffer
Ein Puffer, der mit WSANAMESPACE_INFOEX Strukturen gefüllt ist. Die zurückgegebenen Strukturen befinden sich aufeinander an der Kopfzeile des Puffers. Informationen mit variabler Größe, die von Zeigern in den Strukturen referenziert werden, verweisen auf Positionen innerhalb des Puffers, die sich zwischen dem Ende der strukturen fester Größe und dem Ende des Puffers befinden. Die Anzahl der ausgefüllten Strukturen ist der Rückgabewert WSAEnumNameSpaceProvidersEx.
Rückgabewert
Die funktion WSAEnumNameSpaceProvidersEx gibt die Anzahl der in lpnspBufferkopierten WSANAMESPACE_INFOEX Strukturen zurück. Andernfalls wird der Wert SOCKET_ERROR zurückgegeben, und eine bestimmte Fehlernummer kann durch Aufrufen WSAGetLastErrorabgerufen werden.
| Fehlercode | Bedeutung |
|---|---|
| Der lpnspBuffer Parameter war ein NULL Zeiger oder die Pufferlänge, lpdwBufferLengthwar zu klein, um alle relevanten WSANAMESPACE_INFOEX Strukturen und zugeordneten Informationen zu empfangen. Wenn dieser Fehler zurückgegeben wird, wird die erforderliche Pufferlänge im parameter lpdwBufferLength zurückgegeben. | |
| Die WS2_32.DLL wurde nicht initialisiert. Die Anwendung muss zuerst WSAStartup- aufrufen, bevor Sie Windows Sockets-Funktionen aufrufen. | |
| Zum Ausführen des Vorgangs war nicht genügend Arbeitsspeicher vorhanden. |
Bemerkungen
Die funktion WSAEnumNameSpaceProvidersEx ist eine erweiterte Version der WSAEnumNameSpaceProviders-funktion. Das anbieterspezifische Daten-BLOB, das dem Namespaceeintrag zugeordnet ist, der im lpProviderInfo Parameter an die WSCInstallNameSpaceEx--Funktion übergeben wird, kann mithilfe WSAEnumNameSpaceProvidersEx--Funktion abgefragt werden.
Derzeit ist der einzige Namespaceanbieter in Windows enthalten, der Informationen im ProviderSpecific Member der WSANAMESPACE_INFOEX-Struktur festlegt, der NS_EMAIL Anbieter ist. 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 WSAEnumNameSpaceProvidersEx- für WSAEnumNameSpaceProvidersExWdefiniert, die Unicode-Version dieser Funktion. Der parameter lpnspBuffer wird für den Datentyp LPSAWSANAMESPACE_INFOEXW definiert und WSANAMESPACE_INFOEXW Strukturen werden erfolgreich zurückgegeben.
Wenn UNICODE oder _UNICODE nicht definiert ist, wird WSAEnumNameSpaceProvidersEx- für WSAEnumNameSpaceProvidersExA-definiert, die ANSI-Version dieser Funktion. Der lpnspBuffer Parameter wird für den datentyp LPSAWSANAMESPACE_INFOEXA definiert, und WSANAMESPACE_INFOEXA Strukturen werden bei Erfolg zurückgegeben.
Windows 8.1 und Windows Server 2012 R2: Die WSAEnumNameSpaceProvidersExW--Funktion wird für Windows Store-Apps unter Windows 8.1, Windows Server 2012 R2 und höher unterstützt.
Anmerkung
Der winsock2.h-Header definiert WSAEnumNameSpaceProvidersEx 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 |
|---|---|
| mindestens unterstützte Client- | Windows 8.1, Windows Vista [Desktop-Apps | UWP-Apps] |
| mindestens unterstützte Server- | Windows Server 2008 [Desktop-Apps | UWP-Apps] |
| Zielplattform- | Fenster |
| Header- | winsock2.h |
| Library | Ws2_32.lib |
| DLL- | Ws2_32.dll |
Siehe auch
NAPI_PROVIDER_INSTALLATION_BLOB