events
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 |