ホーム › System.GroupPolicy › PFNSTATUSMESSAGECALLBACK

PFNSTATUSMESSAGECALLBACK

コールバック

シグネチャ

DWORD PFNSTATUSMESSAGECALLBACK(
    BOOL bVerbose,
    LPWSTR lpMessage
);

パラメーター

フィールド	型	説明
bVerbose	BOOL	メッセージが詳細 (verbose) かどうかを指定します。このパラメーターが TRUE の場合、メッセージは詳細です。このパラメーターが FALSE の場合、メッセージは詳細ではありません。
lpMessage	LPWSTR	メッセージ文字列を格納するバッファーへのポインター。

公式ドキュメント

<b>StatusMessageCallback</b> 関数は、ポリシーの適用時にステータスメッセージを表示するために使用される、アプリケーション定義のコールバック関数です。<b>PFNSTATUSMESSAGECALLBACK</b> 型は、このコールバック関数へのポインターを定義します。

StatusMessageCallback は、アプリケーション定義の関数名のプレースホルダーです。

戻り値

メッセージが正常に表示された場合は ERROR_SUCCESS を返します。それ以外の場合はシステムエラーコードを返します。

解説(Remarks)

システムが ProcessGroupPolicy または ProcessGroupPolicyEx コールバック関数を呼び出すときに、 StatusMessageCallback 関数へのポインターを渡します。

ステータスのユーザーインターフェイスには、標準と詳細 (verbose) の 2 つのモードがあります。詳細メッセージは、コンピューターが詳細モードのときにのみ表示されます。詳細モードを有効にするには、次のレジストリ値を 1 に設定し、ログオフしてからログオンします。コンピューターを再起動する必要はありません。

HKEY_LOCAL_MACHINE\Software\Microsoft\Windows NT\CurrentVersion\Winlogon\VerboseStatus

警告他のスレッドのステータスメッセージを上書きするおそれがあるため、バックグラウンドスレッドから StatusMessageCallback 関数を呼び出さないでください。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)