次の方法で共有

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
 PolicyFlagsPolicy パラメーターが指す CLFS_MGMT_POLICY_STRUCTURE のメンバーは、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 で使用できます。
ターゲット プラットフォーム の デスクトップ
ヘッダー wdm.h (Wdm.h、Ntddk.h、Ntifs.h を含む)
ライブラリ Clfs.lib
DLL Clfs.sys
IRQL <= APC_LEVEL

関連項目

CLFS_MGMT_POLICY