Platform SDK: Synchronization Manager

ISensNetwork::DestinationReachable

Specified connection can be reached.

HRESULT DestinationReachable(
  BSTR bstrDestination,        // Destination name
  BSTR bstrConnection,         // Connection name
  ULONG ulType,                // Connection type
  LPSENS_QOCINFO lpQOCInfo     // Quality of Connection information
);

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.
lpQOCInfo: [out] Pointer to the SENS_QOCINFO structure which contains Quality of Connection information.

Dispatch Identifier

[id(0x00000004)]

Return Values

S_OK: Method returned successfully.

Remarks

SENS calls this method to notify your application that the specified destination can be reached. A pointer to a structure containing Quality of Connection information is also provided.

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

Filtering

Filtering can be performed on the publisher property bstrDestination. To determine reachability, set bstrDestination to the name of desired destination. Filtering can also be performed on the property ulType by setting it to either CONNECTION_LAN or CONNECTION_WAN, or both. Use IEventSubscription::PutPublisherProperty to set the publisher property. Note: if a bstrDestination property is not specified, the DestinationReachable 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.