Platform SDK: Synchronization Manager

ISensNetwork::ConnectionMade

Specified connection has been established.

HRESULT ConnectionMade(
  BSTR bstrConnection,       // Connection name
  ULONG ulType,              // Connection type
  LPSENS_QOCINFO lpQOCInfo   // Pointer to Quality of Connection information
);

Parameters

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(0x00000001)]

Return Values

S_OK: Method returned successfully.

Remarks

SENS calls this method to notify your application that the specified connection has been established. SENS also provides a pointer to a structure containing Quality of Connection information.

type: Connection type. Use 0 for LAN or 1 for WAN.
Note This function is only available for TCP/IP connections.

Filtering

Filtering can be performed on the publisher property ulConnectionMadeType by setting it to either CONNECTION_LAN or CONNECTION_WAN or both. Use IEventSubscription::PutPublisherProperty to set the publisher property.

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.