CheckWindow (Standard 7 SP1)
7/8/2014
The first filter, which is used mainly to filter on the easily obtainable, obvious parameters.
Syntax
HRESULT CheckWindow(
IObjectInfo* pObjectInfo,
[out, retval] CheckWindowResult* Action
);
Parameters
- pObjectInfo
[in] An instance of an object that implements the IObjectInfo interface.
Action
[out, retval] Enumeration that specifies the action to be applied to the window.cwShow = 1 (Tells the service to do nothing to the window.)
cwHide = 2 (Tells the service to move the window off-screen only.)
cwShowGetDetails = 3 (Tells the service to leave the window on-screen, but call CheckWindowContents.)
cwHideGetDetails = 4 (Tells the service to move the window off-screen and call CheckWindowContents.)
Return Value
This function returns the following:
Return value |
Description |
|---|---|
ERROR_SUCCESS |
The operation completed successfully. |
ERROR_INVALID_PARAMETER |
If the IObjectInfo parameter is NULL or of the wrong type. |
Remarks
The CheckWindow function is called from multiple threads from the Dialog Box Filter service, so implementations should allow searches to be reentrant. This function also blocks the operation of the calling window, which means the calling window will not become visible until control returns to it.
Requirements
OS Versions: Standard 7
Header:
Link Library: DialogFilterXmlFilter.tlb