WSAGetServiceClassNameByClassIdA-Funktion (winsock2.h)

  • Artikel

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