WinChangeSwitchEntry: Difference between revisions
mNo edit summary |
|||
| (One intermediate revision by the same user not shown) | |||
| Line 13: | Line 13: | ||
; Non-zero : unsuccessful | ; Non-zero : unsuccessful | ||
[[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 40: | Line 40: | ||
*[[WinQuerySwitchEntry]] | *[[WinQuerySwitchEntry]] | ||
*[[WinQuerySwitchList]] | *[[WinQuerySwitchList]] | ||
*WinQueryWindowProcess | *[[WinQueryWindowProcess]] | ||
== Notes == | == Notes == | ||
Latest revision as of 21:49, 6 August 2023
Modifies the specified entry in the task list.
Syntax
WinChangeSwitchEntry(switchHndl, switchControlStruct)
Parameters
- switchHndl - HSWITCH - input
- The task list switch handle.
- switchControlStruct - SWCNTRL - input
- Switch control data.
Returns
ULONG with values of:
- Zero
- success
- Non-zero
- 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
Example Code
HSWITCH switchHndl; SWCNTRL switchControlStruct; ULONG rc; ... rc = WinChangeSwitchEntry(switchHndl, switchControlStruct); ...
Related Functions
Notes
If the standard window was created with FCF_TASKLIST it is not necessary to call WinChangeSwitchEntry; WinSetWindowText, on its handle, changes the title bar and task list text.
If you want to change a few fields, not many, it is advisable to initialize the switch control structure via WinQuerySwitchEntry. Then modify those fields and call WinChangeSwitchEntry for the update.