Método IWSDiscoveryPublisher::MatchResolveEx (wsddisco.h)
Determina se uma mensagem Resolver corresponde ao host especificado e envia um WS-Discovery mensagem ResolveMatches com informações estendidas se a correspondência for feita.
Sintaxe
HRESULT MatchResolveEx(
[in] const WSD_SOAP_MESSAGE *pResolveMessage,
[in] IWSDMessageParameters *pMessageParameters,
[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,
[in, optional] const WSDXML_ELEMENT *pHeaderAny,
[in, optional] const WSDXML_ELEMENT *pReferenceParameterAny,
[in, optional] const WSDXML_ELEMENT *pPolicyAny,
[in, optional] const WSDXML_ELEMENT *pEndpointReferenceAny,
[in, optional] const WSDXML_ELEMENT *pAny
);
Parâmetros
[in] pResolveMessage
Ponteiro para uma estrutura WSD_SOAP_MESSAGE que representa a mensagem Resolver passada para ResolveHandler do coletor de notificação.
[in] pMessageParameters
Ponteiro para um objeto IWSDMessageParameters que representa os parâmetros de transmissão passados para ResolveHandler do coletor de notificação.
[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 formulário 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 para a 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 da 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. Se pTypesList for especificado, MatchResolveEx usará WS-Discovery lógica correspondente para verificar se os tipos correspondem aos especificados em pResolveMessage.
[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. Se pScopesList for especificado, MatchResolveEx usará WS-Discovery lógica correspondente para verificar se os escopos correspondem aos especificados em pResolveMessage.
[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. pXAddrsList e pXAddrsList-Element> podem não ser NULL.
[in, optional] pHeaderAny
Ponteiro para uma estrutura WSDXML_ELEMENT que contém um elemento XML a ser inserido na seção "ANY" do cabeçalho.
[in, optional] pReferenceParameterAny
Ponteiro para uma estrutura WSDXML_ELEMENT que contém um elemento XML a ser inserido na seção "ANY" das propriedades do parâmetro de referência.
[in, optional] pPolicyAny
Não usado.
[in, optional] pEndpointReferenceAny
Ponteiro para uma estrutura WSDXML_ELEMENT que contém um elemento XML a ser inserido na seção "ANY" do ponto de extremidade.
[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.
Retornar valor
Os possíveis valores retornados incluem, mas não se limitam a, o seguinte:
| 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 editor. Para anexar um coletor, chame RegisterNotificationSink. |
|
Memória insuficiente para concluir a operação. |
Comentários
MatchResolveEx deve ser somente quando o editor de descoberta tiver emitido um retorno de chamada ResolveHandler . pResolveMessage e pMessageParameters são passados diretamente do retorno de chamada para MatchResolveEx. O ResolveHandler também passa informações exigidas pelo editor para determinar se a mensagem Resolver fornecida corresponde e, se for o caso, para emitir uma resposta ResolveMatches, se apropriado.
MatchResolveEx envia mensagens ResolveMatches em todos os adaptadores associados e emite automaticamente retransmissões de mensagens quando exigido pelo WS-Discovery.
Os parâmetros referentes a estruturas de WSDXML_ELEMENT podem ser usados para estender o conteúdo da mensagem ResolveMatches que está sendo enviada com informações personalizadas.
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 (inclua Wsdapi.h) |
| DLL | Wsdapi.dll |