Método IWSDiscoveryPublisher::MatchResolveEx (wsddisco.h)
Determina si un mensaje Resolve coincide con el host especificado y envía un mensaje ResolveMatches WS-Discovery con información extendida si se realiza la coincidencia.
Sintaxis
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
Puntero a una estructura de WSD_SOAP_MESSAGE que representa el mensaje Resolve pasado al ResolveHandler del receptor de notificaciones.
[in] pMessageParameters
Puntero a un objeto IWSDMessageParameters que representa los parámetros de transmisión pasados al ResolveHandler del receptor de notificaciones.
[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] ullMetadataVersion
Versión actual de los metadatos.
[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.
[in] ullMessageNumber
Contador dentro del ámbito del identificador de instancia del mensaje actual. El número de mensaje debe incrementarse para cada mensaje.
[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] pTypesList
Puntero a una estructura de WSD_NAME_LIST que representa la lista de tipos admitidos por el host de publicación. Puede ser NULL. Si se especifica pTypesList , MatchResolveEx usará WS-Discovery lógica coincidente para comprobar que los tipos coinciden con los especificados en pResolveMessage.
[in, optional] pScopesList
Puntero a una estructura de WSD_URI_LIST que representa la lista de ámbitos coincidentes admitidos por el host de publicación. La lista contiene valores hash en forma de cadena. Puede ser NULL. Si se especifica pScopesList , MatchResolveEx usará WS-Discovery lógica coincidente para comprobar que los ámbitos coinciden con los especificados en pResolveMessage.
[in, optional] pXAddrsList
Puntero a una estructura de WSD_URI_LIST que representa la lista de direcciones de transporte admitidas por el host de publicación. Cada cadena de dirección de transporte contiene una dirección y un número de puerto que un host remoto puede usar para la conexión. pXAddrsList y pXAddrsList-Element> pueden no ser NULL.
[in, optional] pHeaderAny
Puntero a una estructura WSDXML_ELEMENT que contiene un elemento XML que se va a insertar en la sección "ANY" del encabezado.
[in, optional] pReferenceParameterAny
Puntero a una estructura de WSDXML_ELEMENT que contiene un elemento XML que se va a insertar en la sección "ANY" de las propiedades del parámetro de referencia.
[in, optional] pPolicyAny
No se usa.
[in, optional] pEndpointReferenceAny
Puntero a una estructura de WSDXML_ELEMENT que contiene un elemento XML que se va a insertar en la sección "ANY" del extremo.
[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 |
|---|---|
|
El método se completó correctamente. |
|
Se cumple una o varias de las condiciones siguientes:
|
|
No se ha iniciado el publicador. La asociación de un receptor de notificaciones inicia el publicador. Para adjuntar un receptor, llame a RegisterNotificationSink. |
|
Memoria insuficiente para completar la operación. |
Comentarios
MatchResolveEx solo debe ser cuando el publicador de detección haya emitido una devolución de llamada ResolveHandler . pResolveMessage y pMessageParameters se pasan directamente desde la devolución de llamada a MatchResolveEx. ResolveHandler también pasa la información requerida por el publicador para determinar si el mensaje Resolve proporcionado coincide y, si es así, para emitir una respuesta ResolveMatches si procede.
MatchResolveEx envía mensajes ResolveMatches en todos los adaptadores enlazados y emite automáticamente retransmisiones de mensajes cuando sea necesario en WS-Discovery.
Los parámetros que hacen referencia a WSDXML_ELEMENT estructuras se pueden usar para ampliar el contenido del mensaje ResolveMatches que se envía con información personalizada.
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 | wsddisco.h (incluya Wsdapi.h) |
| Archivo DLL | Wsdapi.dll |