WinQuerySessionTitle

Get the task list entry title.

Syntax

WinQuerySessionTitle(anchorBlockHndl, sessionId, titleStr, titleStrLen)

Parameters

anchorBlockHndl - HAB - input 

The anchor block handle.

sessionId - ULONG - input 

Session identity of the application whose title is requested or zero for the caller's session.

titleStr - PSZ - output 

Task list title to be returned.

titleStrLen - ULONG - input 

Maximum length of the title to be returned.

Returns

ULONG with values of:

Zero 

Success

Non-zero 

Unsuccessful

WinGetLastError could return:

• PMERR_INVALID_PARAMETERS
• PMERR_INVALID_SESSION_ID

Define (C/C++)

INCL_WINSWITCHLIST or INCL_WIN or INCL_PM

Calling Convention

Cdecl32

Example Code

HAB   anchorBlockHndl;
ULONG sessionId;
PSZ   titleStr;
ULONG titleStrLen;
ULONG rc;
...
rc = WinQuerySessionTitle(anchorBlockHndl, sessionId, titleStr, titleStrLen);
...

Related Functions

• WinAddSwitchEntry
• WinChangeSwitchEntry
• WinCreateSwitchEntry
• WinQuerySwitchEntry
• WinQuerySwitchHandle
• WinQuerySwitchList
• WinQueryTaskTitle
• WinRemoveSwitchEntry
• WinSwitchToProgram