WinQuerySwitchHandle

Get a task list entry handle.

Syntax

WinQuerySwitchHandle (wndwHndl, processId)

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.

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 Convention

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