WinCreateSwitchEntry

Add the entry into the task list.

Syntax
WinCreateSwitchEntry(anchorBlockHndl, switchControlStruct)

Parameters

 * anchorBlockHndl - HAB - input : The anchor block handle.
 * switchControlStruct - SWCNTRL - input : The switch control structure contains information about the newly created task list entry.

Returns
HSWITCH with values of:
 * The switch handle : succuss
 * NULLHANDLE : unsuccessful

WinGetLastError could return:
 * PMERR_INVALID_PARAMETERS
 * PMERR_INVALID_PROCESS_ID
 * PMERR_INVALID_PROGRAM_TYPE
 * PMERR_INVALID_SESSION_ID
 * PMERR_INVALID_SWITCH_HANDLE
 * PMERR_INVALID_WINDOW
 * PMERR_NO_SPACE

Define (C/C++)
INCL_WINSWITCHLIST or INCL_WIN or INCL_PM

Calling Convention
Cdecl32

Example Code
HAB    anchorBlockHndl; SWCNTRL switchControlStruct; HSWITCH rc; ... rc = WinCreateSwitchEntry(anchorBlockHndl, switchControlStruct); ...

Related Functions

 * WinAddSwitchEntry
 * WinQuerySwitchEntry
 * WinQuerySwitchList
 * WinQueryWindowProcess
 * WinRemoveSwitchEntry
 * WinSwitchToProgram