WinSwitchToProgram

WinSwitchToProgram(taskListHndl)

Changes active task.

Parameters

taskListHndl - HSWITCH - input

Task List handle returned by:

• WinAddSwitchEntry
• WinCreateSwitchEntry
• WinQuerySwitchList
• WinQuerySwitchEntry

Returns

Returns ULONG:

• 0 Successful.
• Anything else - unsuccessful.

Possible returns from WinGetLastError:

• PMERR_INVALID_SWITCH_HANDLE

Define (C/C++)

INCL_WINSWITCHLIST or INCL_PM or INCL_WIN

Calling Convention

Cdecl32

Example Code

HSWITCH taskListHndl;
ULONG     rc;
...
rc = WinSwitchToProgram(taskListHndl);
...

Related Functions

• WinAddSwitchEntry
• WinCreateSwitchEntry
• WinQuerySwitchList
• WinQuerySwitchEntry

Notes

Use this function, from a foreground session, to force another session to the foreground. A nonforeground session cannot make itself a foreground session.