WinHSWITCHfromHAPP
(Redirected from WinHSwitchFromHapp)
WinHSWITCHfromHAPP returns the handle of the switch list entry from the application handle. If the application handle is invalid or if no switch list entry exists, then 0 is returned.
Syntax
WinHSWITCHfromHAPP(HAPP happ)
Parameters
- happ (HAPP) - input
- Application handle.
Returns
- hswitch (HSWITCH) - returns
- Switch list handle.
- NULLHANDLE: If the HAPP is invalid, the Switch List Entry is not defined for this HAPP, or an error occurred.
- HSWITCH: The Handle of the Switch List Entry, if HAPP is valid and a Switch List Entry exists.
Remarks
WinHAPPfromPID and WinHSWITCHfromHAPP may be called from non-PM programs. For some versions of OS/2 it may be necessary to import explicitly these APIs using the following ordinals:
- WinHAPPfromPID: PMMERGE.5198
- WinHSWITCHfromHAPP: PMMERGE.5199
This function returns the system task list switch handle for an application, given that application's handle. In the case of WPS/SOM applications, however, the application handle is really the window handle, so please use that in those cases.
Prototype:
HSWITCH APIENTRY16 WinHSwitchFromHapp ( HAPP hApp ) ;
Linkage Definition:
IMPORTS WinHSwitchFromHapp = PMSHAPI.209
Example Code
Declaration:
#define INCL_PMAPI #include <os2.h> HSWITCH WinHSWITCHfromHAPP(HAPP happ)
Example:
int main (int argc, char *argv[], char *envp[])
{
APIRET rc;
HAPP happ;
HSWITCH hswitch;
SWCNTRL swcntrl;
PID pid;
if (argc==1) {
printf("QSWLIST pid\n");
return 0; } /* endif */
pid=strtoul(argv[1],NULL,0);
happ=WinHAPPfromPID(pid); /* get HAPP from PID */
hswitch=WinHSWITCHfromHAPP(happ); /* get HSWITCH from HAPP */
rc=WinQuerySwitchEntry(hswitch, swcntrl); /* interpret HSWITCH */
if (rc) {
printf("WinQuerySwitchEntry returned %u\n",rc);
return rc;
} /* endif */
printf("Pid %04x, Happ %08x, Hswitch %08x\n", pid, happ, hswitch);
printf("swcntrl.hwnd \t%08x, swcntrl.hwndIcon \t%08x\n",
swcntrl.hwnd, swcntrl.hwndIcon);
printf("swcntrl.hprog \t%08x, swcntrl.idProcess \t%08x\n",
swcntrl.hprog, swcntrl.idProcess);
printf("swcntrl.idSession\t%08x, swcntrl.uchVisbility\t%08x\n",
swcntrl.idSession, swcntrl.uchVisibility);
printf("swcntrl.fbJump \t%08x, swcntrl.bProgType \t%08x\n",
swcntrl.fbJump, swcntrl.bProgType);
printf("swcntrl.szSwtitle %s\n", swcntrl.szSwtitle);
return 0;
}