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 |