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 陣列中指定的保留大小之後。
*azureAlignReservation 中傳回的值會當做 AllocReservedLog 的輸入使用。 如果 AllocReservedLog 成功,這個值一律大於零 (0) 。 如果 AllocReservedLog 失敗,則值為零 (0) 。
傳回值
如果函式成功,則傳回非零的值。
如果函式失敗,傳回值會是零 (0) 。 若要取得擴充的錯誤資訊,請呼叫 GetLastError。 下列清單會識別可能的錯誤碼:
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows Vista [僅限傳統型應用程式] |
最低支援的伺服器 | Windows Server 2003 R2 [僅限傳統型應用程式] |
目標平台 | Windows |
標頭 | clfsw32.h |
程式庫 | Clfsw32.lib |
Dll | Clfsw32.dll |