SocketWrench .NET Edition

InternetDialer.Handle Property

Gets and sets the handle for the current dial-up networking connection.

[Visual Basic]
Public Property Handle As Integer
[C#]
public int Handle {get; set;}

Property Value

An integer value which specifies a dial-up networking connection.

Remarks

The Handle property returns the handle to the current dial-up networking connection, or a value of zero if the class has not been used to establish a connection. Setting the value of this property to a valid handle causes the class to inherit the specified connection, and its properties will be updated with information about that connection. This enables an application to monitor and control a connection that was established by another program.

Setting the Handle property to a value of zero causes the class to release the current connection, however it will not cause the dial-up networking session to terminate. To disconnect from the remote server, the Disconnect method must be called by the application. Setting the property to a non-zero value which does not specify a valid handle will generate an exception.

See Also

InternetDialer Class | SocketTools Namespace