Compartilhar via


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
S_OK
Método concluído com êxito.
E_POINTER
pszServiceId é NULL.
E_INVALIDARG
O comprimento em caracteres de pszServiceId excede WSD_MAX_TEXT_LENGTH (8192) ou pszServiceId não foi encontrado na lista de serviços registrados.
E_FAIL
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

Confira também

Iwsddevicehost