WSCEnumNameSpaceProviders32-Funktion (ws2spi.h)

  • Artikel

Die WSCEnumNameSpaceProviders32-Funktion gibt Informationen zu verfügbaren 32-Bit-Namespaceanbietern zurück.

Hinweis Bei diesem Aufruf handelt es sich um eine streng 32-Bit-Version von WSAEnumNameSpaceProviders für die Verwendung auf 64-Bit-Plattformen. Es wird bereitgestellt, um 64-Bit-Prozessen den Zugriff auf die 32-Bit-Kataloge zu ermöglichen.

 

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
WSAEFAULT
 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.
WSANOTINITIALISIERT
 Die WS2_32.DLL wurde nicht initialisiert. Die Anwendung muss zuerst WSAStartup aufrufen, bevor sie Windows Sockets-Funktionen aufruft.
WSA_NOT_ENOUGH_MEMORY
 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

Weitere Informationen

WSAEnumNameSpaceProviders

WSANAMESPACE_INFOW

WSCInstallNameSpace32

WSCInstallNameSpaceEx32