FreeReservedLog 函式 (clfsw32.h)

減少封送處理區域中的保留記錄數目，方法是呼叫 ReserveAndAppendLog、 ReserveAndAppendLogAligned 或 AllocReservedLog。藉由使用此函式，用戶端可以釋放封送處理區域中保留的一組匯總記錄和位元組。

語法

CLFSUSER_API BOOL FreeReservedLog(
  [in, out] PVOID     pvMarshal,
  [in]      ULONG     cReservedRecords,
  [in, out] PLONGLONG pcbAdjustment
);

[in, out] pvMarshal

使用 CreateLogMarshallingArea 函式配置之不透明封送處理內容的指標。

[in] cReservedRecords

要釋放的保留記錄數目。

如果調整的位元組計數為正數， cReservedRecords 是調整后剩餘的保留記錄總數。否則，此參數會指定要從目前保留記錄數目減去的記錄數目，但不能超過保留計數。

[in, out] pcbAdjustment

受調整影響的保留空間位元元組數目。

在輸入上，如果此數位為正數，它會在調整后指定保留空間的總剩餘大小。如果此參數是負數，則其絕對值是要釋放的位元元組數目。

此值通常是先前呼叫下列專案所傳回的實際保留空間匯總：

如果函式成功，則傳回非零的值。

如果此函式失敗，則傳回值為零。若要取得擴充的錯誤資訊，請呼叫 GetLastError。下列清單會識別可能的錯誤碼：

當您保留記錄時，您會保留特定大小。當您釋放這些記錄時，必須釋放相同的大小。