PFNSTATUSMESSAGECALLBACK コールバック関数 (userenv.h)

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

構文

PFNSTATUSMESSAGECALLBACK Pfnstatusmessagecallback;

DWORD Pfnstatusmessagecallback(
  [in] BOOL bVerbose,
  [in] LPWSTR lpMessage
)
{...}

パラメーター

[in] bVerbose

メッセージが詳細かどうかを指定します。 このパラメーターが TRUE の場合、メッセージは詳細です。 このパラメーターが FALSE の場合、メッセージは詳細ではありません。

[in] lpMessage

メッセージ文字列を含むバッファーへのポインター。

戻り値

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

解説

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

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

Hkey_local_machine\ソフトウェア\マイクロソフト\Windows NT\CurrentVersion\Winlogon\VerboseStatus

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

 

要件

サポートされている最小のクライアント	Windows Vista
サポートされている最小のサーバー	Windows Server 2008
対象プラットフォーム	Windows
ヘッダー	userenv.h

関連項目

グループ ポリシー関数

グループ ポリシーの概要

ProcessGroupPolicy

ProcessGroupPolicyEx