CheckWindowContents (Industry 8.1)
7/8/2014
Review the use, syntax, parameters, and return values of the CheckWindowContents method of the IObjectFilterEx API in Windows Embedded 8.1 Industry (Industry 8.1).
This method filters the inner and outer parts of the window, including the process name, the window title, the window class, and the top level control names and control types. It performs actions on the window based on the result of the CheckWindow filter. Dialog Filter calls this filter after calling CheckWindow.
Syntax
HRESULT CheckWindowContents(
IObjectInfo* pObjectInfo
);
Parameters
- pObjectInfo
[in] An instance of an object that implements the IObjectInfo interface.
Return Value
Returns ERROR_SUCCESS if successful.
Remarks
CheckWindowContents is the second filter, used mainly to filter or log the content of the window. Because logging can be an expensive operation in terms of processor load, logging is independent of window usage. The user can interact with the window while this operation is occurring. This method is single-threaded, so the service will serialize calls to it. This method is also responsible for performing whatever action is specified, such as pressing a button or sending a close message to a window.