WSAInstallServiceClassW-Funktion (winsock2.h)

Artikel
03/09/2024

Die WSAInstallServiceClass-Funktion registriert ein Dienstklassenschema in einem Namespace. Dieses Schema enthält den Klassennamen, den Klassenbezeichner und alle namespacespezifischen Informationen, die allen Instanzen des Diensts gemeinsam sind, z. B. dem SAP-Bezeichner oder dem Objektbezeichner.

Syntax

INT WSAAPI WSAInstallServiceClassW(
  [in] LPWSASERVICECLASSINFOW lpServiceClassInfo
);

Parameter

[in] lpServiceClassInfo

Dienstklasse zu namespacespezifischen Zuordnungsinformationen. Mehrere Zuordnungen können gleichzeitig verarbeitet werden.

Eine Beschreibung der relevanten Datenstrukturen finden Sie im Abschnitt Dienstklassendatenstrukturen .

Rückgabewert

Der Rückgabewert ist 0, wenn der Vorgang erfolgreich war. 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 Namespaceanbieter kann die angeforderten Klasseninformationen nicht bereitstellen.
WSA_NOT_ENOUGH_MEMORY	Zum Ausführen des Vorgangs war nicht genügend Arbeitsspeicher vorhanden.
WSAEACCES	Die aufrufende Funktion verfügt nicht über ausreichende Berechtigungen zum Installieren des Diensts.
WSAEALREADY	Dienstklasseninformationen wurden bereits für diesen Dienstklassenbezeichner registriert. Verwenden Sie zum Ändern von Dienstklasseninformationen zuerst WSARemoveServiceClass, und installieren Sie dann mit aktualisierten Klasseninformationsdaten neu.
WSAEINVAL	Die Dienstklasseninformationen waren nicht gültig oder nicht ordnungsgemäß strukturiert. Dieser Fehler wird zurückgegeben, wenn der lpServiceClassInfo-ParameterNULL ist.
WSAEOPNOTSUPP	Der Vorgang wird nicht unterstützt. Dieser Fehler wird zurückgegeben, wenn der Namespaceanbieter diese Funktion nicht implementiert.
WSANO_DATA	Der angeforderte Name ist gültig, es wurde jedoch keine Daten mit dem angeforderten Typ gefunden.
WSANOTINITIALISIERT	Die WS2_32.DLL wurde nicht initialisiert. Die Anwendung muss zuerst WSAStartup aufrufen, bevor sie Windows Sockets-Funktionen aufruft.

Hinweise

Hinweis

Der winsock2.h-Header definiert WSAInstallServiceClass als Alias, der automatisch die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit nicht codierungsneutralem Code 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 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	winsock2.h
Bibliothek	Ws2_32.lib
DLL	Ws2_32.dll