UID | title | description | helpviewer_keywords | old-location | tech.root | ms.assetid | ms.date | ms.keywords | req.header | req.include-header | req.target-type | req.target-min-winverclnt | req.target-min-winversvr | req.kmdf-ver | req.umdf-ver | req.ddi-compliance | req.unicode-ansi | req.idl | req.max-support | req.namespace | req.assembly | req.type-library | req.lib | req.dll | req.irql | targetos | req.typenames | req.redist | ms.custom | f1_keywords | dev_langs | topic_type | api_type | api_location | api_name | ||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
NF:wsddisco.IWSDiscoveryPublisher.MatchProbeEx |
IWSDiscoveryPublisher::MatchProbeEx (wsddisco.h) |
Determines whether a Probe message matches the specified host and sends a WS-Discovery ProbeMatches message with extended information if the match is made. |
|
ncd\iwsdiscoverypublisher_matchprobeex_method.htm |
ncd |
d2441bdc-848b-48c4-bc4e-5b8f854cc4a5 |
12/05/2018 |
IWSDiscoveryPublisher interface,MatchProbeEx method, IWSDiscoveryPublisher.MatchProbeEx, IWSDiscoveryPublisher::MatchProbeEx, MatchProbeEx, MatchProbeEx method, MatchProbeEx method,IWSDiscoveryPublisher interface, ncd.iwsdiscoverypublisher_matchprobeex_method, wsddisco/IWSDiscoveryPublisher::MatchProbeEx |
wsddisco.h |
Wsdapi.h |
Windows |
Windows Vista [desktop apps only] |
Windows Server 2008 [desktop apps only] |
Wsddisco.idl |
Wsdapi.dll |
Windows |
19H1 |
|
|
|
|
|
|
Determines whether a Probe message matches the specified host and sends a WS-Discovery ProbeMatches message with extended information if the match is made.
Pointer to a WSD_SOAP_MESSAGE structure that represents the Probe message passed to the notification sink's ProbeHandler.
Pointer to an IWSDMessageParameters object that represents the transmission parameters passed in to the notification sink's ProbeHandler.
The logical or physical address of the device, which is used as the device endpoint address. A logical address is of the form urn:uuid:{guid}
. A physical address can be a URI prefixed by http or https, or simply a URI prefixed by uri
. Whenever possible, use a logical address.
Current metadata version.
Identifier for the current instance of the device being published. This identifier must be incremented whenever the service is restarted. For more information about instance identifiers, see Appendix I of the WS-Discovery specification.
Counter within the scope of the instance identifier for the current message. The message number must be incremented for each message.
Unique identifier within the scope of the instance identifier for the current session. This parameter corresponds to the sequence identifier in the AppSequence block in the Probe message. For more information about sequence identifiers, see Appendix I of the WS-Discovery specification.
This parameter may be NULL.
Pointer to a WSD_NAME_LIST structure that represents the list of types supported by the publishing host. May be NULL.
If pTypesList is specified, MatchProbe will use WS-Discovery matching logic to verify that the types in the list match the types specified in pProbeMessage.
Pointer to a WSD_URI_LIST structure that represents the list of matching scopes supported by the publishing host. The list contains hash values in string form. May be NULL.
If pScopesList is specified, MatchProbe will use WS-Discovery matching logic to verify that the scopes in the list match the scopes specified in pProbeMessage.
Pointer to a WSD_URI_LIST structure that represents the list of transport addresses supported by the publishing host. Each transport address string contains an address and port number which can be used for connection by a remote host. May be NULL.
Pointer to a WSDXML_ELEMENT structure that contains an XML element to be inserted in the "ANY" section of the header.
Pointer to a WSDXML_ELEMENT structure that contains an XML element to be inserted in the "ANY" section of the reference parameter properties.
Not used.
Pointer to a WSDXML_ELEMENT structure that contains an XML element to be inserted in the "ANY" section of the endpoint.
Pointer to a WSDXML_ELEMENT structure that contains an XML element to be inserted in the "ANY" section of the message body.
Possible return values include, but are not limited to, the following:
Return code | Description |
---|---|
|
The method completed successfully. |
|
One or more of the following conditions is true:
|
|
The publisher has not been started. Attaching a notification sink starts the publisher. To attach a sink, call RegisterNotificationSink. |
|
Insufficient memory to complete the operation. |
MatchProbeEx should be called only when the discovery publisher has issued a ProbeHandler callback. pProbeMessage and pMessageParameters are passed directly from the callback into MatchProbeEx. The ProbeHandler also passes information required by the publisher to determine if the supplied Probe message matches and, if so, to issue a ProbeMatches response if appropriate.
MatchProbeEx sends ProbeMatches messages on all bound adapters and automatically issues message retransmissions when required by WS-Discovery.
The parameters referring to WSDXML_ELEMENT structures can be used to extend the contents of the ProbeMatches message being sent with custom information.