Método IWSDiscoveryPublisher::UnPublish (wsddisco.h)
Anuncia a saída de um host de rede enviando uma mensagem bye .
Sintaxe
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
O endereço lógico ou físico do dispositivo, que é usado como o endereço do ponto de extremidade do dispositivo. Um endereço lógico é do formato urn:uuid:{guid}. Um endereço físico pode ser um URI prefixado por http ou https ou simplesmente um URI prefixado por uri. Sempre que possível, use um endereço lógico.
[in] ullInstanceId
Identificador da instância atual do dispositivo que está sendo publicado. Esse identificador deve ser incrementado sempre que o serviço é reiniciado. Para obter mais informações sobre identificadores de instância, consulte Apêndice I da especificação WS-Discovery.
[in] ullMessageNumber
Contador dentro do escopo do identificador de instância para a mensagem atual. O número da mensagem deve ser incrementado para cada mensagem.
[in, optional] pszSessionId
Identificador exclusivo dentro do escopo do identificador de instância para a sessão atual. Esse parâmetro corresponde ao identificador de sequência no bloco AppSequence na mensagem De investigação. Para obter mais informações sobre identificadores de sequência, consulte Apêndice I da especificação WS-Discovery.
Esse parâmetro pode ser NULL.
[in, optional] pAny
Ponteiro para uma estrutura WSDXML_ELEMENT que contém um elemento XML a ser inserido na seção "ANY" do corpo da mensagem.
Valor retornado
Os valores retornados possíveis incluem, mas não se limitam a:
| Código de retorno | Descrição |
|---|---|
|
O método foi concluído com sucesso. |
|
Uma ou mais das seguintes condições são verdadeiras:
|
|
O editor não foi iniciado. Anexar um coletor de notificação inicia o publicador. Para anexar um coletor, chame RegisterNotificationSink. |
|
Memória insuficiente para concluir a operação. |
Comentários
Se tiver êxito, a publicação enviará uma mensagem de bye WS-Discovery para a sub-rede local com as informações fornecidas.
Requisitos
| 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 | wsddisco.h (include Wsdapi.h) |
| DLL | Wsdapi.dll |