WinQuerySwitchEntry

WinQuerySwitchEntry(switchHndl, switchControl)

Get information on a task list entry.

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 conversion

Cdecl32

Example Code

HSWITCH switchHndl;
SWCNTRL switchControl;
ULONG   rc;
...
rc = WinQuerySwitchEntry(switchHndle, switchControl);
...

Related Functions

• WinAddSwitchEntry
• WinCreateSwitchEntry
• WinQuerySwitchList
• WinQueryWindowProcess