Compartir a través de

Método IWSDiscoveryPublisher::UnPublish (wsddisco.h)

  • Artículo

Anuncia la salida de un host de red enviando un mensaje bye .

Sintaxis

HRESULT UnPublish(
  [in]           LPCWSTR              pszId,
  [in]           ULONGLONG            ullInstanceId,
  [in]           ULONGLONG            ullMessageNumber,
  [in, optional] LPCWSTR              pszSessionId,
  [in, optional] const WSDXML_ELEMENT *pAny
);

Parámetros

[in] pszId

La dirección lógica o física del dispositivo, que se usa como dirección del punto de conexión del dispositivo. Una dirección lógica tiene el formato urn:uuid:{guid}. Una dirección física puede tener un prefijo de URI por http o https, o simplemente un URI con el prefijo uri. Siempre que sea posible, use una dirección lógica.

[in] ullInstanceId

Identificador de la instancia actual del dispositivo que se está publicando. Este identificador debe incrementarse cada vez que se reinicie el servicio. Para obtener más información sobre los identificadores de instancia, consulte el Apéndice I de la especificación WS-Discovery.

Nota Para la compatibilidad con la especificación WS-Discovery, este valor debe ser menor o igual que UINT_MAX (4294967295).
 

[in] ullMessageNumber

Contador dentro del ámbito del identificador de instancia del mensaje actual. El número de mensaje debe incrementarse para cada mensaje.

Nota Para la compatibilidad con la especificación WS-Discovery, este valor debe ser menor o igual que UINT_MAX (4294967295).
 

[in, optional] pszSessionId

Identificador único dentro del ámbito del identificador de instancia de la sesión actual. Este parámetro corresponde al identificador de secuencia del bloque AppSequence del mensaje de sondeo. Para obtener más información sobre los identificadores de secuencia, consulte el Apéndice I de la especificación WS-Discovery.

Este parámetro puede ser NULL.

[in, optional] pAny

Puntero a una estructura WSDXML_ELEMENT que contiene un elemento XML que se va a insertar en la sección "ANY" del cuerpo del mensaje.

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_INVALIDARG
 Se cumple una o varias de las condiciones siguientes:
  • pszId es NULL.
  • La longitud de pszId supera WSD_MAX_TEXT_LENGTH (8192).
  • La longitud de pszSessionId supera WSD_MAX_TEXT_LENGTH (8192).
E_ABORT
 No se ha iniciado el publicador. La asociación de un receptor de notificaciones inicia el publicador. Para adjuntar un receptor, llame a RegisterNotificationSink.
E_OUTOFMEMORY
 Memoria insuficiente para completar la operación.

Observaciones

Si se ejecuta correctamente, UnPublish enviará un mensaje de WS-Discovery Bye a la subred local con la información proporcionada.

Requisitos

   
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 wsddisco.h (incluya Wsdapi.h)
Archivo DLL Wsdapi.dll

Consulte también

IWSDiscoveryPublisher