WlxDisplayStatusMessage function

[The WlxDisplayStatusMessage function is no longer available for use as of Windows Server 2008 and Windows Vista.]

The WlxDisplayStatusMessage function must be implemented by a replacement GINA DLL. Winlogon calls this function when the GINA DLL should display a message.

Note   GINA DLLs are ignored in Windows Vista.
 

Syntax


BOOL WlxDisplayStatusMessage(
  _In_ PVOID pWlxContext,
  _In_ HDESK hDesktop,
  _In_ DWORD dwOptions,
  _In_ PWSTR pTitle,
  _In_ PWSTR pMessage
);

Parameters

pWlxContext [in]

Pointer to the GINA context associated with this window station. The GINA returns this context value when Winlogon calls WlxInitialize for this station.

hDesktop [in]

A handle to the desktop where the status message should be displayed.

dwOptions [in]

Specifies display options for the status dialog box. The following options are valid:

STATUSMSG_OPTION_NOANIMATION

STATUSMSG_OPTION_SETFOREGROUND

pTitle [in]

Pointer to a null-terminated wide character string that specifies the title of the message to be displayed.

pMessage [in]

Pointer to a null-terminated wide character string that specifies the message to be displayed.

Return value

Return codeDescription
TRUE

Returns TRUE if the message was displayed.

FALSE

Returns FALSE if the message was not displayed.

 

Requirements

Minimum supported client

Windows XP [desktop apps only]

Minimum supported server

Windows Server 2003 [desktop apps only]

End of client support

Windows XP

End of server support

Windows Server 2003

Header

Winwlx.h

See also

WlxInitialize

 

 

Show: