WinQuerySwitchHandle

WinQuerySwitchHandle

WinQuerySwitchHandle(wndwHndl, processId)

Get a task list entry handle.

Parameters

wndwHndl - HWND - input

Window handle or NULLHANDLE if specifying with processId.

processId - PID - input

Process identifier in the task list or zero if using the window handle.

Constants

None

Returns

Returns of HSWITCH with values of the switch handle or zero with an error occurring.

Possible returns from WinGetLastError:

• PMERR_INVALID_PARAMETERS
• PMERR_INVALID_PROCESS_ID
• PMERR_INVALID_WINDOW

Define (C/C++)

INCL_WINSWITCHLIST or INCL_WIN or INCL_PM

Calling conversion

Cdecl32

Example Code

HWND  wndwHndl;
PID    processId;
HSWITCH rc;
...
rc = WinQuerySwitchHandle(wndwHndl, NULL);
...

OR

...
rc = WinQuerySwitchHandle(NULL, processId);
...

Related Functions

WinQuerySwitchEntry WinQueryWindowProcess WinRemoveSwitchEntry

Notes

If wndwHndl and processId are used, they must be correct

OS Version Introduced

Back to OS/2 API