WSAGetServiceClassNameByClassIdA-Funktion (winsock2.h)

Artikel
08/27/2023

Die WSAGetServiceClassNameByClassId-Funktion ruft den Namen des Diensts ab, der dem angegebenen Typ zugeordnet ist. Dieser Name ist der generische Dienstname, z. B. FTP oder SNA, und nicht der Name einer bestimmten instance dieses Diensts.

Syntax

INT WSAAPI WSAGetServiceClassNameByClassIdA(
  [in]      LPGUID  lpServiceClassId,
  [out]     LPSTR   lpszServiceClassName,
  [in, out] LPDWORD lpdwBufferLength
);

Parameter

[in] lpServiceClassId

Ein Zeiger auf die GUID für die Dienstklasse.

[out] lpszServiceClassName

Ein Zeiger auf den Dienstnamen.

[in, out] lpdwBufferLength

Bei der Eingabe die Länge des von lpszServiceClassName zurückgegebenen Puffers in Zeichen. Bei der Ausgabe die Länge des In lpszServiceClassName kopierten Dienstnamens in Zeichen.

Rückgabewert

Die WSAGetServiceClassNameByClassId-Funktion gibt bei erfolgreicher Ausführung den Wert 0 (null) zurück. Andernfalls wird der Wert SOCKET_ERROR zurückgegeben, und eine bestimmte Fehlernummer kann durch Aufrufen von WSAGetLastError abgerufen werden.

Fehlercode	Bedeutung
WSA_INVALID_PARAMETER	Der angegebene lpServiceClassId-Parameter ist ungültig.
WSA_NOT_ENOUGH_MEMORY	Es war nicht genügend Arbeitsspeicher vorhanden, um den Vorgang auszuführen.
WSAEACCES	Die Aufrufroutine verfügt nicht über ausreichende Berechtigungen für den Zugriff auf die Informationen.
WSAEFAULT	Der angegebene Puffer, auf den lpszServiceClassName verweist, ist zu klein. Übergeben Sie einen größeren Puffer.
WSAENOBUFS	Kein Pufferspeicher verfügbar.
WSAEOPNOTSUPP	Der Vorgang wird für den Typ des Objekts, auf das verwiesen wird, nicht unterstützt. Dieser Fehler wird von einigen Namespaceanbietern zurückgegeben, die das Abrufen von Dienstklasseninformationen nicht unterstützen.
WSANO_DATA	Die lpServiceClassId ist gültig, aber es wurden keine Daten des angeforderten Typs gefunden.
WSANOTINITIALISIERT	Die WS2_32.DLL wurde nicht initialisiert. Die Anwendung muss zuerst WSAStartup aufrufen, bevor Windows Sockets-Funktionen aufgerufen werden.

Hinweise

Hinweis

Der winsock2.h-Header definiert WSAGetServiceClassNameByClassId 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 2000 Professional [Desktop-Apps \| UWP-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [Desktop-Apps \| UWP-Apps]
Zielplattform	Windows
Kopfzeile	winsock2.h
Bibliothek	Ws2_32.lib
DLL	Ws2_32.dll

Weitere Informationen

WSAStartup

Winsock-Funktionen

Winsock-Referenz

Freigeben über