IWSDDeviceHost::RetireService-Methode (wsdhost.h)
Hebt die Registrierung eines Dienstobjekts auf, das mit RegisterService registriert wurde, und entfernt den Dienst aus den Gerätehostmetadaten.
Syntax
HRESULT RetireService(
[in] LPCWSTR pszServiceId
);
Parameter
[in] pszServiceId
Die ID des zu entfernenden Diensts.
Rückgabewert
Mögliche Rückgabewerte sind unter anderem folgendes:
| Rückgabecode | BESCHREIBUNG |
|---|---|
|
Die Methode wurde erfolgreich abgeschlossen. |
|
pszServiceId ist NULL. |
|
Die Länge in Zeichen von pszServiceId überschreitet WSD_MAX_TEXT_LENGTH (8192), oder pszServiceId wurde in der Liste der registrierten Dienste nicht gefunden. |
|
Fehler bei der Methode. Möglicherweise ist ein Fehler aufgetreten, weil der Host nicht initialisiert wurde. Rufen Sie Init auf, um einen Gerätehost zu initialisieren. |
Hinweise
Der Gerätehost gibt seinen Verweis auf das Dienstobjekt frei, nachdem die Registrierung des Diensts aufgehoben wurde. Das Dienstobjekt empfängt keine Rückrufe, nachdem RetireService abgeschlossen wurde.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows Vista [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2008 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | wsdhost.h (include Wsdapi.h) |
| DLL | Wsdapi.dll |