LogMessageEx (Industry 8.1)
7/8/2014
Review the use, syntax, parameters, and return values of the LogMessageEx method of the IObjectFilterEx API in Windows Embedded 8.1 Industry (Industry 8.1).
This method implements logging additional Dialog Filter messages to the Windows Event Log.
Syntax
HRESULT LogMessageEx(
[in] MessageType type,
IObjectInfo* pObjectInfo,
[in] BSTR szActionPerformed
);
Parameters
type
[in] An enumeration representing the type of message to log. Enumeration values include the following:Value
Description
lmActionBlocked = 6
Logs a message indicating that Dialog Filter took an action on the window because the window is configured as part of the list of blocked windows.
lmActionProtected = 7
Logs a message indicating that Dialog Filter took an action on the window because the window is configured as part of the list of protected windows.
lmActionDefault = 8
Logs a message indicating the Dialog Filter took the default action on the window.
lmSkipped = 9
Logs a message indicating that Dialog Filter took no action on the window and skipped it.
- pObjectInfo
A pointer to an instance of the IObjectInfo interface.
- szActionPerformed
[in] A string that indicates the action that Dialog Filter performed on the window.
Return Value
Returns the following:
Return value |
Description |
---|---|
ERROR_SUCCESS |
The operation completed successfully. |
ERROR_INVALID_PARAMETER |
A parameter is NULL or of the wrong type. |
Remarks
Custom filters can implement logging using any method or use the default logging, which is sent to the Windows Event Log (under Applications and Services\Microsoft\Windows\DialogFilter).