DirectedProbe Method
[This documentation is for preview only, and is subject to change in later releases. Blank topics are included as placeholders.]
Sends a directed probe request and parses probe matches responses.
Namespace: Dpws.Client.Discovery
Assembly: MFDpwsClient (in MFDpwsClient.dll)
Syntax
'Declaration
Public Function DirectedProbe ( _
endpointAddress As String, _
targetServiceAddress As String, _
filters As DpwsServiceTypes _
) As DpwsServiceDescriptions
public DpwsServiceDescriptions DirectedProbe(
string endpointAddress,
string targetServiceAddress,
DpwsServiceTypes filters
)
public:
DpwsServiceDescriptions^ DirectedProbe(
String^ endpointAddress,
String^ targetServiceAddress,
DpwsServiceTypes^ filters
)
member DirectedProbe :
endpointAddress:string *
targetServiceAddress:string *
filters:DpwsServiceTypes -> DpwsServiceDescriptions
public function DirectedProbe(
endpointAddress : String,
targetServiceAddress : String,
filters : DpwsServiceTypes
) : DpwsServiceDescriptions
Parameters
- endpointAddress
Type: System. . :: . .String
A DPWS devices transport endpoint address (for example, https://192.168.0.1:8084/3cb0d1ba-cc3a-46ce-b416-212ac2419b20).
- targetServiceAddress
Type: System. . :: . .String
The target service address of a known service. For DPWS, this address would represent a device's address (for example, urn:uuid:3cb0d1ba-cc3a-46ce-b416-212ac2419b20).
- filters
Type: Dpws.Client. . :: . .DpwsServiceTypes
An object that contains a collection of types that a service must support to signal a match. A null value for this parameter indicates any type.
Return Value
Type: Dpws.Client.Discovery. . :: . .DpwsServiceDescriptions
A collection of DpwsServiceDescription objects. A probe match object contains endpoint details used to locate the actual service on a network and the types supported by the service.
Remarks
A directed Probe is used to discover services on a network. The DirectedProbe method sends an HTTP request to the service-specified endpointAddress parameter. Any service that implements types specified in the filters parameter should respond with a probe matches message. The probe matches message is returned as the response to the DirectedProbe request. If a null filter is supplied, any DPWS-compliant service should reply with a probe matches response. This method is used to directly ask for service endpoint information.
.NET Framework Security
- Full trust for the immediate caller. This member cannot be used by partially trusted code. For more information, see dd66cd4c-b087-415f-9c3e-94e3a1835f74.