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 |
|---|---|
| Der Namespaceanbieter kann die angeforderten Klasseninformationen nicht bereitstellen. | |
| Es war nicht genügend Arbeitsspeicher vorhanden, um den Vorgang auszuführen. | |
| Die aufrufende Funktion verfügt nicht über ausreichende Berechtigungen, um den Dienst zu installieren. | |
| 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. | |
| Die Dienstklasseninformationen waren ungültig oder falsch strukturiert. Dieser Fehler wird zurückgegeben, wenn der lpServiceClassInfo-ParameterNULL ist. | |
| Der Vorgang wird nicht unterstützt. Dieser Fehler wird zurückgegeben, wenn der Namespaceanbieter diese Funktion nicht implementiert. | |
| Der angeforderte Name ist gültig, es wurde jedoch keine Daten mit dem angeforderten Typ 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 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 |