AddLogContainer 関数 (clfsw32.h)

呼び出し元のプロセスが .blf ファイルへの書き込みアクセス権を持ち、コンテナーのターゲット ディレクトリにファイルを作成する機能がある場合は、ログ ハンドルに関連付けられている物理ログにコンテナーを追加します。

この関数は、コンテナーを 1 つだけ追加するため、 AddLogContainerSet とは異なります。 複数のコンテナーを追加するには、 AddLogContainerSet を使用する方が効率的です。これにより、複数のコンテナーを追加できます。 コンテナーを追加すると、クライアントはログのサイズを増やすことができます。

構文

CLFSUSER_API BOOL AddLogContainer(
  [in]                HANDLE     hLog,
  [in, optional]      PULONGLONG pcbContainer,
  [in]                LPWSTR     pwszContainerPath,
  [in, out, optional] LPVOID     pReserved
);

パラメーター

[in] hLog

開いているログへのハンドル。

ハンドルは、ログへの書き込みアクセス権を持つ CreateLogFile から取得する必要があります。 クライアント アプリケーションには、.blf ファイルへの書き込みアクセス権と、コンテナーのターゲット ディレクトリにファイルを作成する機能が必要です。

[in, optional] pcbContainer

コンテナーのサイズをバイト単位で指定する省略可能なパラメーター。

最小サイズは、通常のログの場合は 512 KB、多重化されたログの場合は 1024 KB です。 最大サイズは約 4 ギガバイトです。

コンテナーが新しく作成されたログに追加される場合は、このパラメーターが必要です。 コンテナーが既に作成されている場合、このパラメーターは NULL、または最初のコンテナーのサイズと少なくとも同じ大きさの値にすることができます。

ログ コンテナーのサイズは、ログ領域サイズ (512 KB) の倍数です。 新しいファイルにコンテナーを追加すると、 AddLogContainer 関数はコンテナーのサイズを次の 512 KB の境界に切り上げ、そのサイズを pcbContainer が指す値で返します。

同様に、ログに少なくとも 1 つのコンテナーがあり、 *pcbContainer の値が現在のコンテナー サイズと少なくとも同じ大きさである場合、関数は現在の内部サイズを持つすべてのコンテナーを作成し、そのサイズを *pcbContainer で返します。

[in] pwszContainerPath

ログ ボリューム上の新しいコンテナーの有効なパスを含む null で終わる文字列へのポインター。

[in, out, optional] pReserved

予約済み。 pReserved を NULL に設定します

戻り値

関数が成功すると、戻り値は 0 以外になります。

関数が失敗した場合は、0 を返します。 詳細なエラー情報を得るには、GetLastError を呼び出します。

次の一覧は、考えられるエラー コードを示しています。

要件

要件
サポートされている最小のクライアント Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2003 R2 [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー clfsw32.h
Library Clfsw32.lib
[DLL] Clfsw32.dll

こちらもご覧ください

AddLogContainerSet

一般的なログ ファイル システム関数

CreateLogFile