Share via


SetWindowInfo (Standard 7 SP1)

7/8/2014

This function initializes the values of an ObjectInfo object.

Syntax

HRESULT SetWindowInfo(
    [in] ULONG ProcessId,
    [in] BSTR ProcessName,
    [in] FILTER_HWND Handle,
    [in] BSTR WindowClass,
    [in] BSTR WindowTitle,
    [in] LONG X,
    [in] LONG Y
);

Parameters

  • ProcessId
    The unique identifier of the window's process (also known as a PID) that can be seen in the Windows Task Manager.
  • ProcessName
    The name of the process.
  • Handle
    The handle (HWND) that the operating system assigned to the window.
  • WindowClass
    The WindowClass is a string value used by the programming language and kernel to categorize and group windows by their purpose.  It is never visible to the user but can be seen using tools such as Spy++.
  • WindowTitle
    The title of the window.
  • X
    Numeric expression that specifies, in twips, the horizontal distance of the left edge of the dialog box from the left edge of the screen. This measurement refers to the position of the dialog box before it is moved off-screen.
  • Y
    Numeric expression that specifies, in twips, the vertical distance of the upper edge of the dialog box from the top of the screen. This measurement refers to the position of the dialog box before it is moved off-screen.

Return Value

This function returns the following:

Return value

Description

ERROR_SUCCESS

The operation completed successfully.

ERROR_INVALID_PARAMETER

If a parameter is NULL or of the wrong type.

Remarks

None.

Requirements

OS Versions: Standard 7

Header:

Link Library: DialogFilterXmlFilter.tlb

See Also

Reference

ReadWindowContents
ObjectInfo Class
CreateObjectInfo