SetLogFileSizeWithPolicy 関数 (clfsmgmtw32.h)
インストールされているポリシーの状態に基づいて、ログからコンテナーを追加または削除します。
構文
CLFSUSER_API BOOL SetLogFileSizeWithPolicy(
[in] HANDLE hLog,
[in] PULONGLONG pDesiredSize,
[out] PULONGLONG pResultingSize
);
パラメーター
[in] hLog
ログへのハンドル。
[in] pDesiredSize
次のいずれかの値として表される、要求されたログ サイズを指定する値へのポインター。 実際の結果サイズについては、 pResultingSize パラメーターを 参照してください。
| 値 | 意味 |
|---|---|
|
最小サイズ ポリシーを適用します。
最小サイズ ポリシーがインストールされていない場合は、次のいずれかが発生します。
最小サイズ ポリシーがインストールされている場合は、次のいずれかが発生します。
詳細については、「 InstallLogPolicy」を参照してください。 |
|
有効な値ではありません。関数呼び出しは 、ERROR_INVALID_PARAMETERで失敗します。 |
|
コンテナーの数として表される、ログの目的のサイズ。
この数が、インストールされているポリシーで指定されたコンテナーの最小数より小さい場合、関数呼び出しは ERROR_COULD_NOT_RESIZE_LOGで失敗します。 この数がインストールされているポリシーで指定されたコンテナーの最大数を超える場合、ログはポリシーで指定されたコンテナーの最大数までしか拡張されません。この関数はエラーなしで成功します。 |
|
最大サイズ ポリシーがインストールされていない場合、関数呼び出しは ERROR_LOG_POLICY_CONFLICTで失敗します。
最大サイズ ポリシーがインストールされている場合、ログは最大サイズ ポリシーで指定されたコンテナーの最大数に拡張され、関数はエラーなしで成功します。 |
[out] pResultingSize
有効な ULONGLONG データ変数へのポインターは、成功した場合にサイズ変更されたログ内のコンテナーの数を受け取ります。
戻り値
関数が成功すると、戻り値は 0 以外になります。
関数が失敗した場合は、0 を返します。 エラーの詳細情報を得るには、GetLastError 関数を呼び出します。
解説
コンテナーは、.blf ファイルと同じセキュリティ属性を使用して作成され、.blf ファイルの所有者のコンテキストではなく、アプリケーションのコンテキスト内で作成されます。 .blf ファイルの詳細については、「ログの 種類」を参照してください。 コンテナーが削除された場合、コンテナーは呼び出し元アプリケーションのセキュリティ コンテキストを使用して削除されます。
例
この関数を使用する例については、「 ログ ファイルの作成」を参照してください。
要件
| サポートされている最小のクライアント | Windows Vista [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows Server 2003 R2 [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | clfsmgmtw32.h |
| Library | Clfsw32.lib |
| [DLL] | Clfsw32.dll |