WSAInstallServiceClassW-Funktion (winsock2.h)
Die WSAInstallServiceClass-Funktion registriert ein Dienstklassenschema in einem Namespace. Dieses Schema umfasst 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 WSAInstallServiceClassW(
[in] LPWSASERVICECLASSINFOW lpServiceClassInfo
);
Parameter
[in] lpServiceClassInfo
Dienstklasse für Namespace-Spezifische Zuordnungsinformationen. Mehrere Zuordnungen können gleichzeitig verarbeitet werden.
Eine Beschreibung relevanter Datenstrukturen finden Sie im Abschnitt Service Class Data Structures.
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 WSAGetLastErrorabgerufen werden.
| Fehlercode | Bedeutung |
|---|---|
| Der Namespaceanbieter kann die angeforderten Klasseninformationen nicht bereitstellen. | |
| Zum Ausführen des Vorgangs war nicht genügend Arbeitsspeicher vorhanden. | |
| Die aufrufende Funktion verfügt nicht über ausreichende Berechtigungen zum Installieren des Diensts. | |
| Dienstklasseninformationen wurden bereits für diesen Dienstklassenbezeichner registriert. Verwenden Sie zum Ändern von Dienstklasseninformationen zuerst WSARemoveServiceClassund installieren Sie dann erneut mit aktualisierten Klasseninformationsdaten. | |
| Die Dienstklasseninformationen waren ungültig oder nicht ordnungsgemäß strukturiert. Dieser Fehler wird zurückgegeben, wenn der parameter lpServiceClassInfoNULList. | |
| Der Vorgang wird nicht unterstützt. Dieser Fehler wird zurückgegeben, wenn der Namespaceanbieter diese Funktion nicht implementiert. | |
| Der angeforderte Name 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 Sie Windows Sockets-Funktionen aufrufen. |
Bemerkungen
Anmerkung
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
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Windows 2000 Professional [nur Desktop-Apps] |
| mindestens unterstützte Server- | Windows 2000 Server [nur Desktop-Apps] |
| Zielplattform- | Fenster |
| Header- | winsock2.h |
| Library | Ws2_32.lib |
| DLL- | Ws2_32.dll |