WSAInstallServiceClassA-Funktion (winsock2.h)

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. den SAP-Bezeichner oder den Objektbezeichner.

Syntax

INT WSAAPI WSAInstallServiceClassA(
  [in] LPWSASERVICECLASSINFOA lpServiceClassInfo
);

Parameter

[in] lpServiceClassInfo

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

Eine Beschreibung der relevanten Datenstrukturen finden Sie im Abschnitt Dienstklassendatenstrukturen .

Rückgabewert

Der Rückgabewert ist null, 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	Es war nicht genügend Arbeitsspeicher vorhanden, um den Vorgang auszuführen.
WSAEACCES	Die aufrufende Funktion verfügt nicht über ausreichende Berechtigungen, um den Dienst zu installieren.
WSAEALREADY	Dienstklasseninformationen wurden bereits für diesen Dienstklassenbezeichner registriert. Verwenden Sie zum Ändern der Dienstklasseninformationen zunächst WSARemoveServiceClass, und installieren Sie dann mit aktualisierten Klasseninformationsdaten neu.
WSAEINVAL	Die Dienstklasseninformationen waren ungültig oder falsch 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 Windows Sockets-Funktionen aufgerufen werden.

Hinweise

Hinweis

Der winsock2.h-Header definiert WSAInstallServiceClass 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

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

Weitere Informationen

WSAGetLastError

WSAGetServiceClassInfo

WSASERVICECLASSINFO

Winsock-Funktionen

Winsock-Referenz