Handle Property

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

Syntax

object.Handle [= hrasconn]

Remarks

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

Setting the Handle property to a value of zero causes the control 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 error.

Data Type

Integer

See Also

AutoConnect Property, Connected Property, Connection Property, Connections Property