EnterCriticalPolicySection 関数 (userenv.h)
EnterCriticalPolicySection 関数は、ポリシーのアプリケーションを一時停止して、アプリケーションがポリシー設定を安全に読み取ることができるようにします。 アプリケーションは、複数のポリシー エントリを読み取り、読み取り中に設定が変更されないようにする必要がある場合に、この関数を呼び出します。 このミューテックスは、グループ ポリシー オブジェクト (GPO) に格納されているすべてのクライアント側拡張機能のグループ ポリシー処理を保護します。
構文
USERENVAPI HANDLE EnterCriticalPolicySection(
[in] BOOL bMachine
);
パラメーター
[in] bMachine
コンピューター ポリシーまたはユーザー ポリシーのアプリケーションを停止するかどうかを示す 値。 この値が TRUE の場合、システムはコンピューター ポリシーの適用を停止します。 この値が FALSE の場合、システムはユーザー ポリシーの適用を停止します。
戻り値
関数が成功した場合、戻り値はポリシー セクションへのハンドルです。
関数が失敗した場合は、返される値は NULL です。 エラーの詳細情報を得るには、GetLastError 関数を呼び出します。
注釈
アプリケーションがクリティカル セクションを保持できる最大時間は 10 分です。 10 分後、システムはクリティカル セクションを解放し、ポリシーを再度適用できます。
コンピューター クリティカル セクション オブジェクトとユーザー クリティカル セクション オブジェクトの両方を取得するには、コンピューター クリティカル セクション オブジェクトを取得する前に、ユーザー クリティカル セクション オブジェクトを取得します。 これは、デッドロックの状況を防ぐのに役立ちます。
ハンドルを閉じるには、 LeaveCriticalPolicySection 関数を呼び出します。 ポリシー セクション ハンドルは、他の Windows 関数では使用できません。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows Vista |
| サポートされている最小のサーバー | Windows Server 2008 |
| 対象プラットフォーム | Windows |
| ヘッダー | userenv.h |
| Library | Userenv.lib |
| [DLL] | Userenv.dll |