AlignReservedLog-Funktion (clfsw32.h)

Berechnet die sektororientierte Reservierungsgröße für einen Satz reservierter Datensätze. Dieser Wert wird dann an AllocReservedLog übergeben, um einen Block des Protokollspeichers für eine Reihe von Datensätzen zu reservieren.

Syntax

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

Parameter

[in, out] pvMarshal

Ein Zeiger auf den undurchsichtigen Marshallkontext, der durch Aufrufen der CreateLogMarshallingArea-Funktion zugeordnet wird.

[in] cReservedRecords

Die Anzahl der reservierten Datensätze, die der Reservierungsanpassung zugeordnet sind.

[in] rgcbReservation

Ein Array von Speicherplatzzuordnungen, die im Protokoll reserviert werden sollen, das dem aktuellen Marshallkontext zugeordnet ist, in Bytes.

Die Anzahl der Zuordnungen entspricht der Anzahl von Datensätzen, die cReservedRecords angibt. Jede Zuordnung muss größer als 0 (0) sein, andernfalls schlägt die Funktion mit ERROR_INVALID_PARAMETER fehl.

[out] pcbAlignReservation

Ein Zeiger auf eine Variable, in der die Funktion die Anzahl des im Protokoll zu reservierenden bereichsorientierten Bytespeichers zurückgibt, nachdem die Anzahl von Datensätzen, die cRecords angibt, und die Größe der Reservierungen im rgcbReservation-Array angegeben wurde.

Der in *pcbAlignReservation zurückgegebene Wert wird als Eingabe für AllocReservedLog verwendet. Wenn AllocReservedLog erfolgreich ist, ist dieser Wert immer größer als 0 (0). Wenn AllocReservedLog fehlschlägt, ist der Wert null (0).

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null.

Wenn die Funktion fehlschlägt, ist der Rückgabewert 0 (null). Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf. In der folgenden Liste werden die möglichen Fehlercodes identifiziert:

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 R2 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	clfsw32.h
Bibliothek	Clfsw32.lib
DLL	Clfsw32.dll

Weitere Informationen

AllocReservedLog

Allgemeine Protokolldateisystemfunktionen