Método IWSDiscoveryPublisher::P ublish (wsddisco.h)
Anuncia a presença de um host de rede enviando uma mensagem Olá .
Sintaxe
HRESULT Publish(
[in] LPCWSTR pszId,
[in] ULONGLONG ullMetadataVersion,
[in] ULONGLONG ullInstanceId,
[in] ULONGLONG ullMessageNumber,
[in, optional] LPCWSTR pszSessionId,
[in, optional] const WSD_NAME_LIST *pTypesList,
[in, optional] const WSD_URI_LIST *pScopesList,
[in, optional] const WSD_URI_LIST *pXAddrsList
);
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] ullMetadataVersion
Versão de metadados atual.
[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] pTypesList
Ponteiro para uma estrutura WSD_NAME_LIST que representa a lista de tipos com suporte pelo host de publicação. Pode ser NULL.
[in, optional] pScopesList
Ponteiro para uma estrutura WSD_URI_LIST que representa a lista de escopos correspondentes com suporte pelo host de publicação. A lista contém valores de hash no formato de cadeia de caracteres. Pode ser NULL.
[in, optional] pXAddrsList
Ponteiro para uma estrutura de WSD_URI_LIST que representa a lista de endereços de transporte compatíveis com o host de publicação. Cada cadeia de caracteres de endereço de transporte contém um endereço e um número de porta que podem ser usados para conexão por um host remoto. Pode ser NULL.
Retornar valor
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:
|
|
Não há nenhum coletor de notificação registrado. Para anexar um coletor, chame RegisterNotificationSink. |
|
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, Publicar enviará uma mensagem do WS-Discovery Hello para a sub-rede local com as informações fornecidas.
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 | wsddisco.h (include Wsdapi.h) |
| DLL | Wsdapi.dll |