Método IWSDDeviceHost::RetireService (wsdhost.h)
Cancela o registro de um objeto de serviço que foi registrado usando RegisterService e remove o serviço dos metadados do host do dispositivo.
Sintaxe
HRESULT RetireService(
[in] LPCWSTR pszServiceId
);
Parâmetros
[in] pszServiceId
A ID do serviço a ser removido.
Retornar valor
Os valores retornados possíveis incluem, mas não se limitam a:
Código de retorno | Descrição |
---|---|
|
Método concluído com êxito. |
|
pszServiceId é NULL. |
|
O comprimento em caracteres de pszServiceId excede WSD_MAX_TEXT_LENGTH (8192) ou pszServiceId não foi encontrado na lista de serviços registrados. |
|
O método falhou. Pode ter falhado porque o host não foi inicializado. Chame Init para inicializar um host do dispositivo. |
Comentários
O host do dispositivo libera sua referência ao objeto de serviço depois que o serviço não é registrado. O objeto de serviço não receberá retornos de chamada após a conclusão do RetireService .
Requisitos
Requisito | Valor |
---|---|
Cliente mínimo com suporte | Windows Vista [somente aplicativos da área de trabalho] |
Servidor mínimo com suporte | Windows Server 2008 [somente aplicativos da área de trabalho] |
Plataforma de Destino | Windows |
Cabeçalho | wsdhost.h (include Wsdapi.h) |
DLL | Wsdapi.dll |