WSAGetServiceClassNameByClassIdA-Funktion (winsock2.h)

Artikel
11/20/2024

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 Instanz 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 eingaben, die Länge des Puffers, der von lpszServiceClassNamein Zeichen zurückgegeben wird. Bei der Ausgabe wird die Länge des Dienstnamens in lpszServiceClassNamein Zeichen kopiert.

Rückgabewert

Die WSAGetServiceClassNameByClassId Funktion gibt bei erfolgreicher Ausführung einen Wert von Null zurück. Andernfalls wird der Wert SOCKET_ERROR zurückgegeben, und eine bestimmte Fehlernummer kann durch Aufrufen WSAGetLastErrorabgerufen werden.

Fehlercode	Bedeutung
WSA_INVALID_PARAMETER	Der angegebene parameter lpServiceClassId ist ungültig.
WSA_NOT_ENOUGH_MEMORY	Zum Ausführen des Vorgangs war nicht genügend Arbeitsspeicher vorhanden.
WSAEACCES	Die Anrufroutine verfügt nicht über ausreichende Berechtigungen für den Zugriff auf die Informationen.
WSAEFAULT-	Der angegebene Puffer, der von lpszServiceClassName verweist, ist zu klein. Übergeben Sie einen größeren Puffer.
WSAENOBUFS	Kein Pufferspeicher verfügbar.
WSAEOPNOTSUPP	Der Vorgang wird für den Objekttyp, auf den 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 Sie Windows Sockets-Funktionen aufrufen.

Bemerkungen

Anmerkung

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
mindestens unterstützte Client-	Windows 2000 Professional [Desktop-Apps \| UWP-Apps]
mindestens unterstützte Server-	Windows 2000 Server [Desktop-Apps \| UWP-Apps]
Zielplattform-	Fenster
Header-	winsock2.h
Library	Ws2_32.lib
DLL-	Ws2_32.dll

Siehe auch

WSAStartup-

Winsock-Funktionen

Winsock Reference

Freigeben über