WlxGetStatusMessage 函式 (winwlx.h)

[WlxGetStatusMessage 函式已不再可供 Windows Server 2008 和 Windows Vista 使用。]

WlxGetStatusMessage函式必須由取代GINA DLL 實作。 Winlogon 會呼叫此函式,以取得 GINA DLL 所顯示的狀態訊息。

注意 Windows Vista 中會忽略 GINA DLL。
 

語法

BOOL WlxGetStatusMessage(
  [in]  PVOID pWlxContext,
  [out] DWORD *pdwOptions,
  [out] PWSTR pMessage,
  [in]  DWORD dwBufferSize
);

參數

[in] pWlxContext

與此視窗月臺相關聯的 GINA 內容指標。 當 Winlogon 為此月臺呼叫 WlxInitialize 時,GINA 會傳回此內容值。

[out] pdwOptions

DWORD 的指標,該 DWORD 會保存目前狀態訊息的顯示選項。

[out] pMessage

傳回目前的狀態訊息正文。

[in] dwBufferSize

pMessage緩衝區的大小。

傳回值

傳回碼 描述
TRUE
如果擷取訊息,則會傳回 TRUE
FALSE
如果未擷取訊息,則會傳回 FALSE

規格需求

   
最低支援的用戶端 Windows XP [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2003 [僅限桌面應用程式]
目標平台 Windows
標頭 winwlx.h

另請參閱

WlxDisplayStatusMessage

WlxInitialize

WlxRemoveStatusMessage