WSAGetServiceClassNameByClassIdA-Funktion (winsock2.h)
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 |
|---|---|
| Der angegebene lpServiceClassId-Parameter ist ungültig. | |
| Es war nicht genügend Arbeitsspeicher vorhanden, um den Vorgang auszuführen. | |
| Die Aufrufroutine verfügt nicht über ausreichende Berechtigungen für den Zugriff auf die Informationen. | |
| Der angegebene Puffer, auf den lpszServiceClassName verweist, ist zu klein. Übergeben Sie einen größeren Puffer. | |
| Kein Pufferspeicher verfügbar. | |
| 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. | |
| Die lpServiceClassId ist gültig, aber es wurden keine Daten des angeforderten Typs gefunden. | |
| 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 |