WSCEnumNameSpaceProvidersEx32-Funktion (ws2spi.h)
Die WSCEnumNameSpaceProvidersEx32-Funktion ruft Informationen zu verfügbaren 32-Bit-Namespaceanbietern ab.
Syntax
INT WSAAPI WSCEnumNameSpaceProvidersEx32(
[in, out] LPDWORD lpdwBufferLength,
[out] LPWSANAMESPACE_INFOEXW lpnspBuffer
);
Parameter
[in, out] lpdwBufferLength
Bei der Eingabe die Anzahl der Bytes, die im Puffer enthalten sind, auf die lpnspBuffer verweist. Bei der Ausgabe (wenn die Funktion fehlschlägt und der Fehler WSAEFAULT ist), die Mindestanzahl von Bytes, die für den lpnspBuffer-Puffer zugewiesen werden sollen, damit alle angeforderten Informationen abgerufen werden können. Der an WSCEnumNameSpaceProvidersEx32 übergebene Puffer muss ausreichen, um alle Namespaceinformationen zu enthalten.
[out] lpnspBuffer
Ein Puffer, der mit WSANAMESPACE_INFOEXW Strukturen gefüllt ist. Die zurückgegebenen Strukturen befinden sich nacheinander am Kopf des Puffers. Informationen zu variablen Größen, auf die von Zeigern in den Strukturen verwiesen wird, verweisen auf Positionen innerhalb des Puffers, die sich zwischen dem Ende der Strukturen mit fester Größe und dem Ende des Puffers befinden. Die Anzahl der eingegebenen Strukturen ist der Rückgabewert von WSCEnumNameSpaceProvidersEx32.
Rückgabewert
Die WSCEnumNameSpaceProvidersEx32-Funktion gibt die Anzahl der WSANAMESPACE_INFOEXW Strukturen zurück, die in lpnspBuffer kopiert wurden. Andernfalls wird der Wert SOCKET_ERROR zurückgegeben, und eine bestimmte Fehlernummer kann durch Aufrufen von WSAGetLastError abgerufen werden.
| Fehlercode | Bedeutung |
|---|---|
| Die Pufferlänge war zu klein, um alle relevanten WSANAMESPACE_INFOEXW Strukturen und zugeordneten Informationen zu empfangen, oder der lpnspBuffer-Parameter war ein **NULL**-Zeiger. 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 aufruft. | |
| Zum Ausführen des Vorgangs war nicht genügend Arbeitsspeicher vorhanden. |
Hinweise
WSCEnumNameSpaceProvidersEx32 ist eine 32-Bit-Version von WSAEnumNameSpaceProvidersEx. Auf einem 64-Bit-Computer werden alle Aufrufe, die nicht speziell 32-Bit-Aufrufe (z. B. alle Funktionen, die nicht auf "32" enden) im nativen 64-Bit-Katalog ausgeführt. Prozesse, die auf einem 64-Bit-Computer ausgeführt werden, müssen die spezifischen 32-Bit-Funktionsaufrufe verwenden, um mit einem strikten 32-Bit-Katalog zu arbeiten und die Kompatibilität aufrechtzuerhalten. Die Definitionen und Semantik der spezifischen 32-Bit-Aufrufe sind identisch mit ihren nativen Gegenstücken.
Derzeit ist der einzige in Windows enthaltene Namespace, der Informationen im ProviderSpecific-Member der WSANAMESPACE_INFOEXW-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 .
Die 32-Bit-SPI-Funktion entspricht der nativen API-Funktion (WSAEnumNameSpaceProvidersEx), da es kein Konzept eines "ausgeblendeten" Namespaceanbieters gibt.
Das anbieterspezifische Datenblob, das dem Namespaceeintrag zugeordnet ist, der im lpProviderInfo-Parameter an die WSCInstallNameSpaceEx32-Funktion übergeben wird, kann mithilfe der Funktion WSCEnumNameSpaceProvidersEx32 abgefragt werden.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows Vista [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2008 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | ws2spi.h |
| Bibliothek | Ws2_32.lib |
| DLL | Ws2_32.dll |