AlignReservedLog 関数 (clfsw32.h)

予約レコードのセットのセクターアライン予約サイズを計算します。 その後、この値は AllocReservedLog に渡され、一連のレコードのログ領域のブロックを予約します。

構文

CLFSUSER_API BOOL AlignReservedLog(
  [in, out] PVOID       pvMarshal,
  [in]      ULONG       cReservedRecords,
  [in]      LONGLONG [] rgcbReservation,
  [out]     PLONGLONG   pcbAlignReservation
);

パラメーター

[in, out] pvMarshal

CreateLogMarshallingArea 関数を呼び出すことによって割り当てられる不透明なマーシャリング コンテキストへのポインター。

[in] cReservedRecords

予約調整に関連付けられている予約レコードの数。

[in] rgcbReservation

現在のマーシャリング コンテキストに関連付けられているログに予約する領域割り当ての配列 (バイト単位)。

割り当ての数は、 cReservedRecords が指定するレコードの数に対応します。 各割り当ては 0 より大きい値である必要があります。または、 関数がERROR_INVALID_PARAMETERで失敗します。

[out] pcbAlignReservation

cRecords が指定するレコードの数と rgcbReservation 配列で指定された予約のサイズが指定された後に、関数がログに予約するセクターアラインバイト領域の数を返す変数へのポインター。

*pcbAlignReservation で返される値は、AllocReservedLog への入力として使用されます。 AllocReservedLog が成功した場合、この値は常に 0 (0) より大きくなります。 AllocReservedLog が失敗した場合、値はゼロ (0) になります。

戻り値

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

関数が失敗した場合は、0 を返します。 詳細なエラー情報を得るには、GetLastError を呼び出します。 次の一覧は、考えられるエラー コードを示しています。

要件

こちらもご覧ください

AllocReservedLog

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