WSCEnumNameSpaceProviders32-Funktion (ws2spi.h)
Die WSCEnumNameSpaceProviders32-Funktion gibt Informationen zu verfügbaren 32-Bit-Namespaceanbietern zurück.
Syntax
INT WSAAPI WSCEnumNameSpaceProviders32(
[in, out] LPDWORD lpdwBufferLength,
[out] LPWSANAMESPACE_INFOW 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 WSCEnumNameSpaceProviders32 übergebene Puffer muss ausreichend sein, um alle Namespaceinformationen zu enthalten.
[out] lpnspBuffer
Ein Puffer, der mit WSANAMESPACE_INFOW 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 WSCEnumNameSpaceProviders32.
Rückgabewert
Die WSCEnumNameSpaceProviders32-Funktion gibt die Anzahl WSANAMESPACE_INFOW 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 |
|---|---|
| Der lpnspBuffer-Parameter war ein **NULL**-Zeiger, oder die Pufferlänge lpdwBufferLength war zu klein, um alle relevanten WSANAMESPACE_INFOW 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 aufruft. | |
| Zum Ausführen des Vorgangs war nicht genügend Arbeitsspeicher vorhanden. |
Hinweise
WSCEnumNameSpaceProviders32 ist eine streng 32-Bit-Version von WSAEnumNameSpaceProviders. 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.
Die 32-Bit-SPI-Funktion entspricht der nativen API-Funktion (WSAEnumNameSpaceProviders), da es kein Konzept eines "ausgeblendeten" Namespaceanbieters gibt.
Die WSCEnumNameSpaceProviders32-Funktion ist eine reine Unicode-Funktion und gibt WSANAMESPACE_INFOEXW Strukturen zurück.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows Vista, Windows XP Professional x64 Edition [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2008, Windows Server 2003 x64 Edition [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | ws2spi.h |
| Bibliothek | Ws2_32.lib |
| DLL | Ws2_32.dll |