Platform SDK: Synchronization Manager

ISensNetwork::DestinationReachableNoQOCInfo

Specified connection can be reached with no Quality of Connection information.

HRESULT DestinationReachableNoQOCInfo(
  BSTR bstrDestination,    // Destination name
  BSTR bstrConnection,     // Connection name
  ULONG ulType             // Connection type
);

Parameters

bstrDestination
[in] Name of the destination. Can be an IP address, a URL, a UNC, or a NetBIOS name.
bstrConnection
[in] Name of the connection. For WAN connections, the connection name is the name of the phone book entry; for LAN connections, it is the name of the network card.
ulType
[in] Connection type. This value can be CONNECTION_LAN or CONNECTION_WAN.

Dispatch Identifier

[id(0x00000005)]

Return Values

S_OK
Method returned successfully.

Remarks

SENS calls this method to notify your application that the specified destination can be reached when Quality of Connection information is not available.

Note  This function is only available for TCP/IP connections.

Filtering

Filtering can be performed on the publisher property bstrDestinationNoQOC. To determine reachability, set bstrDestinationNoQOC to the name of desired destination. Filtering can also be performed on the property ulDestinationTypeNoQOC by setting it to either CONNECTION_LAN or CONNECTION_WAN, or both. Use IEventSubscription::PutPublisherProperty to set the publisher property. Note: if a bstrDestinationNoQOC property is not specified, the DestinationReachableNoQOC() event is returned for all destinations.

Requirements

  Windows NT/2000: Requires Windows 2000 (or Windows NT 4.0 with Internet Explorer 5 or later).
  Windows 95/98: Requires Windows 95 or later (with Internet Explorer 5 or later).
  Header: Declared in Sensevts.h.
  Library: Use Sensevts.tlb.

See Also

ISensNetwork::DestinationReachable, About System Event Notification Service, IEventSubscription, IEventSubscription::PutPublisherProperty