IfmManage::DeregisterStartedApplication

This method removes the registration of an application from the Forms Manager.

Syntax

HRESULT DeregisterStartedApplication( OLE_HANDLE hFC, BSTR bstrAppName );

Parameters

hFC

Handle to Forms Manager’s context. It is FC_MAINFACEPLATE.

bstrAppName

Unicode string that contains the name of the application.

Return Values

NOERROR indicates success. If an error occurs, the appropriate HRESULT value is returned.

Remarks

An application needs to register with the Forms Manager to get the focus. An application registered with the Forms Manager should call IfmManage::DeregisterStartedApplication to remove the registration from the application before exiting. Once an application is no longer registered with the Forms Manager, the shell needs to restart the application to restore the focus to that application.

Context handles are always to the faceplate screen.

See Also

IfmManage::RegisterStartedApplication