Condividi tramite


Metodo IWSDDeviceHost::RetireService (wsdhost.h)

Annulla la registrazione di un oggetto servizio registrato tramite RegisterService e rimuove il servizio dai metadati dell'host del dispositivo.

Sintassi

HRESULT RetireService(
  [in] LPCWSTR pszServiceId
);

Parametri

[in] pszServiceId

ID del servizio da rimuovere.

Valore restituito

I valori restituiti possibili includono, ma non sono limitati ai seguenti:

Codice restituito Descrizione
S_OK
Il metodo è stato completato correttamente.
E_POINTER
pszServiceId è NULL.
E_INVALIDARG
La lunghezza in caratteri di pszServiceId supera WSD_MAX_TEXT_LENGTH (8192) o pszServiceId non è stata trovata nell'elenco dei servizi registrati.
E_FAIL
Il metodo non è riuscito. L'errore potrebbe non riuscire perché l'host non è stato inizializzato. Chiamare Init per inizializzare un host del dispositivo.

Commenti

L'host del dispositivo rilascia il riferimento all'oggetto servizio dopo l'annullamento della registrazione del servizio. L'oggetto servizio non riceverà i callback dopo il completamento di RetireService .

Requisiti

Requisito Valore
Client minimo supportato Windows Vista [solo app desktop]
Server minimo supportato Windows Server 2008 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione wsdhost.h (include Wsdapi.h)
DLL Wsdapi.dll

Vedi anche

IWSDDeviceHost