Jump to content

WinQuerySwitchHandle: Difference between revisions

From EDM2
created WinQuerySwitchHandle
 
m formatting
Line 1: Line 1:
== WinQuerySwitchHandle ==
== WinQuerySwitchHandle ==
; WinQuerySwitchHandle(wndwHndl, processId) :
; WinQuerySwitchHandle(wndwHndl, processId) : Get a task list entry handle.
Get a task list entry handle.


=== Parameters ===
=== Parameters ===
; wndwHndl - [[OS2 API:DataType:HWND|HWND]] - input :
; wndwHndl - [[OS2 API:DataType:HWND|HWND]] - input : Window handle or [[OS2 API:DataType:NULLHANDLE|NULLHANDLE]] if specifying with processId.
Window handle or [[OS2 API:DataType:NULLHANDLE|NULLHANDLE]] if specifying with processId.
; processId - [[OS2 API:DataType:PID|PID]] - input : Process identifier in the task list or zero if using the window handle.
; processId - [[OS2 API:DataType:PID|PID]] - input :
Process identifier in the task list or zero if using the window handle.


=== Constants ===
=== Constants ===

Revision as of 04:37, 1 May 2006

WinQuerySwitchHandle

WinQuerySwitchHandle(wndwHndl, processId)
Get a task list entry handle.

Parameters

wndwHndl - HWND - input
Window handle or NULLHANDLE if specifying with processId.
processId - PID - input
Process identifier in the task list or zero if using the window handle.

Constants

None

Returns

Returns of HSWITCH with values of the switch handle or zero with an error occurring.

Possible returns from WinGetLastError:

Module

Define (C/C++)

INCL_WINSWITCHLIST or INCL_WIN or INCL_PM

Export name/Ordinal

Calling conversion

Cdecl32

Example Code

HWND  wndwHndl;
PID    processId;
HSWITCH rc;
...
rc = WinQuerySwitchHandle(wndwHndl, NULL);
...
OR
...
rc = WinQuerySwitchHandle(NULL, processId);
...

Related Functions

WinQuerySwitchEntry WinQueryWindowProcess WinRemoveSwitchEntry

Notes

If wndwHndl and processId are used, they must be correct

OS Version Introduced