Share via


CreateObjectInfo (Standard 7 SP1)

7/8/2014

This method is called by the Dialog Box Filter service to initialize an IObjectInfo instance. The service also provides basic information about the window, however, the implementation can also gather more information 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] 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] 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 function.

Return Value

This function returns the following:

Return value

Description

ERROR_SUCCESS

The operation completed successfully.

ERROR_INVALID_PARAMETER

If an invalid or NULL parameter is supplied.

Remarks

Requirements

OS Versions: Standard 7

Header:

Link Library: DialogFilterXmlFilter.tlb

See Also

Reference

ObjectFilter Class
ObjectInfo Class
CheckWindow