CheckWindow (Industry 8.1)
7/8/2014
Review the use, syntax, parameters, and return values of the CheckWindow method of the IObjectFilterEx API in Windows Embedded 8.1 Industry (Industry 8.1).
This method filters based on the outer parts of the window, including the process name, the window class, and the window title. Dialog Filter calls this filter first.
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.Value
Description
cwShow = 1
The service does nothing to the window.
cwHide = 2
The service moves the window off the screen only.
cwShowGetDetails = 3
The service leaves the window on the screen, but calls CheckWindowContents.
cwHideGetDetails = 4
The service moves the window off the screen and calls CheckWindowContents.
cwDefaultShow = 5
The service leaves the window on the screen as the default action. Used when the current window is not a blocked window and does not belong to a protected process.
cwDefaultShowGetDetails = 6
The service leaves the window on the screen as the default action and calls LogMessageEx to log the window information. Used when the current window is not a blocked window and does not belong to a protected process.
cwDefaultClose = 7
The service closes the window as the default action. Used when the current window is not a blocked window and does not belong to a protected process.
cwDefaultCloseGetDetails = 8
The service closes the window as the default action and calls LogMessageEx to log the window information. Used when the current window is not a blocked window and does not belong to a protected process.
Return Value
Returns the following:
Return value |
Description |
|---|---|
ERROR_SUCCESS |
The operation completed successfully. |
ERROR_INVALID_PARAMETER |
The IObjectInfo parameter is NULL or of the wrong type. |
Remarks
The CheckWindow method is called from multiple threads from the Dialog Filter service, so implementations should allow searches to be reentrant. This method also blocks the operation of the calling window. This means the calling window will not become visible until control returns to it, so long delays will affect application load times.