WinSwitchToProgram: Difference between revisions

Newer edit →

Revision as of 06:59, 20 October 2005

WinSwitchToProgram

WinSwitchToProgram(taskListHndl)

Changes active task.

Parameters

taskListHndl - HSWITCH - input

Task List handle returned by:

Constants

Returns

Returns ULONG:

0 Successful.
Anything else - unsuccessful.

Possible returns from WinGetLastError:

PMERR_INVALID_SWITCH_HANDLE

Module

Define (C/C++)

INCL_WINSWITCHLIST or INCL_PM or INCL_WIN

Export name/Ordinal

Calling conversion

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.