WinQueryTaskTitle: Difference between revisions

Latest revision as of 19:04, 14 May 2025

Get the task list entry.

WinQueryTaskTitle(sessionId, titleReceived, titleLngth)

sessionId - ULONG - input: The session identifier or zero for the caller's session.
titleReceived - PSZ- output: Title of the application as specified with the session identifier.
titleLength - ULONG - input: Maximum length of title, in bytes.

None

APIRET with values of:

WinGetLastError possible returns:

INCL_WINSWITCHLIST or INCL_PM or INCL_WIN

ULONG  sessionId;
PSZ    titleReceived;
ULONG  titleLngth;
APIRET rc;
...
rc = WinQueryTaskTitle(sessionId, titleReceived, titleLngth);
...

WinQuerySessionTitle is the preferred API call.

@@ Line 4: / Line 4: @@
   WinQueryTaskTitle(sessionId, titleReceived, titleLngth)
-=== Parameters ===
+== Parameters ==
 ; sessionId - [[ULONG]] - input : The session identifier or zero for the caller's session.
 ; titleReceived - [[PSZ]]- output : Title of the application as specified with the session identifier.
 ; titleLength - ULONG - input : Maximum length of title, in bytes.
-=== Constants ===
+== Constants ==
 None
-=== Returns ===
+== Returns ==
 [[APIRET]] with values of:
 ;Zero : Success
@@ Line 21: / Line 21: @@
 *[[PM Error Codes#PMERR_INVALID_SESSION_ID|PMERR_INVALID_SESSION_ID]]
-=== Define (C/C++) ===
+== Define (C/C++) ==
 INCL_WINSWITCHLIST or INCL_PM or INCL_WIN
-=== Calling Convention ===
+== Calling Convention ==
 [[Cdecl32]]
-=== Example Code ===
+== Example Code ==
   ULONG  sessionId;
   PSZ    titleReceived;
@@ Line 36: / Line 36: @@
   ...
-=== Related Functions ===
+== Related Functions ==
 *[[WinAddSwitchEntry]]
 *[[WinChangeSwitchEntry]]
@@ Line 44: / Line 44: @@
 *[[WinQuerySwitchHandle]]
 *[[WinQuerySwitchList]]
-*WinTaskSizePos
 *[[WinRemoveSwitchEntry]]
 *[[WinSwitchToProgram]]
-=== Notes ===
+== Notes ==
 [[WinQuerySessionTitle]] is the preferred API call.
 [[Category:Win]]