WinQuerySwitchEntry: Difference between revisions
Appearance
mNo edit summary |
|||
Line 1: | Line 1: | ||
Get information on a task list entry. | |||
==Syntax== | |||
WinQuerySwitchEntry (switchHndl, switchControl) | |||
=== Parameters === | === Parameters === | ||
;switchHndl - [[HSWITCH]] - input : The task list switch handle that was returned by [[WinAddSwitchEntry]], [[WinCreateSwitchEntry]], [[WinQuerySwitchList]], or | ;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. | ;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. | ||
Line 12: | Line 14: | ||
[[WinGetLastError]] could return: | [[WinGetLastError]] could return: | ||
* [[ | * [[PM Error Codes#PMERR_INVALID_PARAMETERS|PMERR_INVALID_PARAMETERS]] | ||
* [[ | * [[PM Error Codes#PMERR_INVALID_PROCESS_ID|PMERR_INVALID_PROCESS_ID]] | ||
* [[ | * [[PM Error Codes#PMERR_INVALID_PROGRAM_TYPE|PMERR_INVALID_PROGRAM_TYPE]] | ||
* [[ | * [[PM Error Codes#PMERR_INVALID_SESSION_ID|PMERR_INVALID_SESSION_ID]] | ||
* [[ | * [[PM Error Codes#PMERR_INVALID_SWITCH_HANDLE|PMERR_INVALID_SWITCH_HANDLE]] | ||
* [[ | * [[PM Error Codes#PMERR_INVALID_WINDOW|PMERR_INVALID_WINDOW]] | ||
* [[ | * [[PM Error Codes#PMERR_NO_SPACE|PMERR_NO_SPACE]] | ||
=== Define (C/C++) === | === Define (C/C++) === | ||
Line 38: | Line 40: | ||
*[[WinCreateSwitchEntry]] | *[[WinCreateSwitchEntry]] | ||
*[[WinQuerySwitchList]] | *[[WinQuerySwitchList]] | ||
* | *WinQueryWindowProcess | ||
[[Category:Win]] | [[Category:Win]] |
Revision as of 16:39, 3 March 2017
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
Example Code
HSWITCH switchHndl; SWCNTRL switchControl; ULONG rc; ... rc = WinQuerySwitchEntry(switchHndle, switchControl); ...
Related Functions
- WinAddSwitchEntry
- WinCreateSwitchEntry
- WinQuerySwitchList
- WinQueryWindowProcess