Compartir a través de

Método IWSDDeviceHost::RetireService (wsdhost.h)

  • Artículo

Anula el registro de un objeto de servicio que se registró mediante RegisterService y quita el servicio de los metadatos del host del dispositivo.

Sintaxis

HRESULT RetireService(
  [in] LPCWSTR pszServiceId
);

Parámetros

[in] pszServiceId

Identificador del servicio que se va a quitar.

Valor devuelto

Entre los valores devueltos posibles se incluyen, entre otros, los siguientes:

Código devuelto Descripción
S_OK
 El método se completó correctamente.
E_POINTER
 pszServiceId es NULL.
E_INVALIDARG
 La longitud de caracteres de pszServiceId supera WSD_MAX_TEXT_LENGTH (8192) o pszServiceId no se encontró en la lista de servicios registrados.
E_FAIL
 Error en el método. Es posible que se haya producido un error porque el host no se ha inicializado. Llame a Init para inicializar un host de dispositivo.

Comentarios

El host del dispositivo libera su referencia al objeto de servicio después de anular el registro del servicio. El objeto de servicio no recibirá devoluciones de llamada después de que RetireService se haya completado.

Requisitos

Requisito Value
Cliente mínimo compatible Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado wsdhost.h (incluya Wsdapi.h)
Archivo DLL Wsdapi.dll

Consulte también

IWSDDeviceHost