ClfsMgmtInstallPolicy 関数 (wdm.h)

  • [アーティクル]

ClfsMgmtInstallPolicy ルーチンは、物理ログにCLFS_MGMT_POLICY構造体を追加します。

構文

CLFSUSER_API NTSTATUS ClfsMgmtInstallPolicy(
  [in] PLOG_FILE_OBJECT  LogFile,
  [in] PCLFS_MGMT_POLICY Policy,
  [in] ULONG             PolicyLength
);

パラメーター

[in] LogFile

CLFS_MGMT_POLICY構造体のこのインスタンスが適用する CLFS ログを表すLOG_FILE_OBJECT構造体へのポインター。 ポリシーは、ログ内の 1 つのストリームが指定された場合でも、ログ内のすべてのストリームに適用されます。

[in] Policy

インストールするポリシーを含む CLFS_MGMT_POLICY 構造体へのポインター。

[in] PolicyLength

Policy パラメーターが指す構造体の長さ (バイト単位)。

戻り値

ClfsMgmtInstallPolicy ルーチンは、次のいずれかの NTSTATUS 値を返します。

リターン コード 説明
STATUS_SUCCESS
 ポリシーがインストールされました。
STATUS_INVALID_PARAMETER_1
 LogFile パラメーターに NULL 値が指定されました。
STATUS_INVALID_PARAMETER_2
 Policy パラメーターに NULL 値が指定されました。
STATUS_INVALID_PARAMETER_3
 PolicyLength パラメーターの値は、CLFS_MGMT_POLICY構造体のインスタンスのサイズより小さくなります。
STATUS_NOT_SUPPORTED
 Policy パラメーターが指すCLFS_MGMT_POLICY_STRUCTUREの PolicyFlags メンバーは、LOG_POLICY_OVERWRITE以外のフラグを指定します。
STATUS_INVALID_PARAMETER
 次の条件のいずれかに該当している場合。
  • Policy パラメーターの Version メンバーは、CLFS_MGMT_POLICY_VERSIONと等しくありません。
  • Policy パラメーターの値は ClfsMgmtPolicyInvalid と等しくなります。
  • Policy パラメーターの PolicyFlags メンバーは、LOG_POLICY_OVERWRITE以外のフラグを指定します。
STATUS_LOG_POLICY_ALREADY_INSTALLED
 ログには既にこの種類のポリシーがあり、LOG_POLICY_OVERWRITE フラグは設定されていません。
STATUS_INSUFFICIENT_RESOURCES
 操作を完了するためのメモリが不足しています。
 

このルーチンは、他の NTSTATUS 値も返す場合があります。

注釈

ポリシーは揮発性です。 ログのすべてのハンドルが閉じられると、ポリシーは失われます。 最初のクライアントを登録するたびにポリシーをインストールする必要があります。

ログ内の最初のコンテナーが作成される前に、PolicyType メンバーが ClfsMgmtPolicyNewContainerSize と等しいCLFS_MGMT_POLICY構造体のみを登録する必要があります。 それ以降の登録は無視されます。

LogFile パラメーターでログ ストリームが指定されている場合でも、インストールされるログ ポリシーは物理ログに適用されます。

要件

要件 値
サポートされている最小のクライアント Windows Server 2003 R2、Windows Vista、およびそれ以降のバージョンの Windows で使用できます。
対象プラットフォーム デスクトップ
Header wdm.h (Wdm.h、Ntddk.h、Ntifs.h を含む)
Library Clfs.lib
[DLL] Clfs.sys
IRQL <= APC_LEVEL

こちらもご覧ください

CLFS_MGMT_POLICY