Probe Method (DpwsServiceTypes, Int32, Int32)
[This documentation is for preview only, and is subject to change in later releases. Blank topics are included as placeholders.]
Sends a Probe request and parses ProbeMatches responses.
Namespace: Dpws.Client.Discovery
Assembly: MFDpwsClient (in MFDpwsClient.dll)
Syntax
'Declaration
Public Function Probe ( _
filters As DpwsServiceTypes, _
maxProbeMatches As Integer, _
timeout As Integer _
) As DpwsServiceDescriptions
public DpwsServiceDescriptions Probe(
DpwsServiceTypes filters,
int maxProbeMatches,
int timeout
)
public:
DpwsServiceDescriptions^ Probe(
DpwsServiceTypes^ filters,
int maxProbeMatches,
int timeout
)
member Probe :
filters:DpwsServiceTypes *
maxProbeMatches:int *
timeout:int -> DpwsServiceDescriptions
public function Probe(
filters : DpwsServiceTypes,
maxProbeMatches : int,
timeout : int
) : DpwsServiceDescriptions
Parameters
- filters
Type: Dpws.Client. . :: . .DpwsServiceTypes
An object that contains a collection of types a service must support to signal a match (null = any type).
- maxProbeMatches
Type: System. . :: . .Int32
The maximum number of matches to receive within the timeout period. Pass 0 to receive as many matches as possible before the timeout expires.
- timeout
Type: System. . :: . .Int32
A request time-out in milliseconds. Pass -1 to wait ReceiveTimeout.
Return Value
Type: Dpws.Client.Discovery. . :: . .DpwsServiceDescriptions
A collection of objects that contain endpoint details used to locate the actual service on a network and the types supported by the service.
Remarks
A Probe is used to discover services on a network. The Probe method sends a UDP request to the DPWS multicast address, 239.255.255.250:3702. Any service that implements types specified in the filters parameter should respond with a ProbeMatches message. The ProbeMatches message is unicast back to the client that made the request. If a null filter is supplied any DPWS-compliant service should reply with a ProbeMatches response. Probe waits ReceiveTimeout for probe matches.
.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.