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 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 (Int32)

See Also

AutoConnect Property, Connection Property, Connections Property, IsConnected Property