CreateObjectInfo (Industry 8.1)
7/8/2014
Review the use, syntax, parameters, and return values of the CreateObjectInfo method of the IObjectFilterEx API in Windows Embedded 8.1 Industry (Industry 8.1).
This method is called by the Dialog Filter service to initialize an IObjectInfoEx interface instance. The service also provides basic information about the window; however, the implementation can also gather more information by using the provided window handle and process ID.
Syntax
HRESULT CreateObjectInfo(
[in] ULONG ProcessID,
[in] BSTR ProcessName,
[in] FILTER_HWND Handle,
[in] BSTR WindowClass,
[in] BSTR WindowTitle,
[in] LONG XPos,
[in] LONG YPos,
[out,retval] IObjectInfo** ppNewObjectInfo
);
Parameters
- ProcessID
[in] The unique identifier of the window's process.
- ProcessName
[in] The name of the process.
- Handle
[in] The handle that the operating system assigned to the process.
- WindowClass
[in] A window class is a set of attributes that the system uses as a template to create a window. Every window is a member of a window class.
- WindowTitle
[in] The title of the window.
- XPos
[in] A numeric expression that specifies, in twips, the horizontal distance of the left edge of the dialog box from the left edge of the screen.
- YPos
[in] A numeric expression that specifies, in twips, the vertical distance of the upper edge of the dialog box from the top of the screen.
- ppNewObjectInfo
[out, retval] An instance of the IObjectInfo interface returned by the CreateObjectInfo method.
Return Value
Returns the following:
Return value |
Description |
|---|---|
ERROR_SUCCESS |
The operation completed successfully. |
ERROR_INVALID_PARAMETER |
An invalid or NULL parameter is supplied. |