CTerminalEmulator::AttachHandle Method  
 
VOID AttachHandle(
  HDISPLAY hDisplay  
);

The AttachHandle method attaches the specified display handle to the current instance of the class.

Parameters

hDisplay
The handle to the virtual display that will be attached to the current instance of the class object.

Return Value

None.

Remarks

This method is used to attach a display handle created outside of the class using the SocketTools API. Once the handle is attached to the class, the other class member functions may be used with that virtual display.

The virtual display for the current instance of the class will be destroyed when the new handle is attached to the class object. If you want to prevent the display handle from being released, you must call the DetachHandle method. Failure to release the detached handle may result in a resource leak in your application.

Note that the hDisplay parameter is presumed to be a valid display handle and no checks are performed to ensure that the handle is valid. Specifying an invalid handle will cause subsequent method calls to fail.

Requirements

Minimum Desktop Platform: Windows 7 (Service Pack 1)
Minimum Server Platform: Windows Server 2008 R2 (Service Pack 1)
Header File: cstools10.h
Import Library: csnvtv10.lib

See Also

DetachHandle, GetHandle