ISensNetwork::ConnectionMade method (sensevts.h)

The ConnectionMade method notifies your application that the specified connection has been established.

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

Syntax

HRESULT ConnectionMade(
  [in] BSTR           bstrConnection,
  [in] ULONG          ulType,
  [in] LPSENS_QOCINFO lpQOCInfo
);

Parameters

[in] bstrConnection

For WAN connections, the information passed is the connection name. For WAN connections, the connection name is the name of the phone book entry. For LAN connections, the information passed is "LAN connection".

[in] ulType

Connection type. This value can be CONNECTION_LAN (0) or CONNECTION_WAN (1).

[in] lpQOCInfo

Pointer to the SENS_QOCINFO structure which contains Quality of Connection information.

Return value

This method can return one of these values.

Return code Description
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.

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

Requirement Value
Minimum supported client Windows XP [desktop apps only]
Minimum supported server Windows Server 2003 [desktop apps only]
Target Platform Windows
Header sensevts.h
DLL Sens.dll

See also

About System Event Notification Service

IEventSubscription

IEventSubscription::PutPublisherProperty

ISensNetwork

ISensNetwork::ConnectionMadeNoQOCInfo

SENS_QOCINFO