Home Library Learn Downloads Support Community
Sign in | United States - English | |
This topic has not yet been rated - Rate this topic

AfxOleUnlockControl

Visual Studio .NET 2003

Unlocks the class factory of the specified control.

Copy 
BOOL AFXAPI AfxOleUnlockControl(
   REFCLSID clsid 
);
BOOL AFXAPI AfxOleUnlockControl(
   LPCTSTR lpszProgID 
);

Parameters

clsid
The unique class ID of the control.
lpszProgID
The unique program ID of the control.

Return Value

Nonzero if the class factory of the control was successfully unlocked; otherwise 0.

Remarks

A control is locked with AfxOleLockControl, so that dynamically created data associated with the control remains in memory. This can significantly speed up display of the control because the control need not be created and destroyed every time it is displayed. When you are ready to destroy the control, call AfxOleUnlockControl.

Example

Copy 
// Unlock controls (Microsoft FlexGrid Control) class factory.
// Structure MSFlexGridLib::MSFlexGrid below obtained from #import of 
// msflxgrd.ocx.

AfxOleUnlockControl(__uuidof(MSFlexGridLib::MSFlexGrid));

Requirements

Header: <afxwin.h>

See Also

MFC Macros and Globals | AfxOleLockControl

Did you find this helpful?
(1500 characters remaining)