WinQuerySwitchEntry

Get information on a task list entry.

Syntax
WinQuerySwitchEntry (switchHndl, switchControl)

Parameters

 * switchHndl - HSWITCH - input : The task list switch handle that was returned by WinAddSwitchEntry, WinCreateSwitchEntry, WinQuerySwitchList, or WinQuerySwitchEntry.
 * switchControl - SWCNTRL - output : The switch control data. Information about the task list entry. Using the field for the program handle, it can be used to invoke the task.

Returns
ULONG with values of:
 * Zero : success
 * Non-zero : not successful

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
HSWITCH switchHndl; SWCNTRL switchControl; ULONG  rc; ... rc = WinQuerySwitchEntry(switchHndle, switchControl); ...

Related Functions

 * WinAddSwitchEntry
 * WinCreateSwitchEntry
 * WinQuerySwitchList
 * WinQueryWindowProcess