AlignReservedLog, fonction (clfsw32.h)

  • Article

Calcule la taille de réservation alignée sur un secteur pour un ensemble d’enregistrements réservés. Cette valeur est ensuite passée à AllocReservedLog pour réserver un bloc d’espace journal pour un jeu d’enregistrements.

Syntaxe

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

Paramètres

[in, out] pvMarshal

Pointeur vers le contexte de marshaling opaque alloué en appelant la fonction CreateLogMarshallingArea .

[in] cReservedRecords

Nombre d’enregistrements réservés associés à l’ajustement de réservation.

[in] rgcbReservation

Tableau d’allocations d’espace à réserver dans le journal associé au contexte de marshaling actuel, en octets.

Le nombre d’allocations correspond au nombre d’enregistrements spécifié par cReservedRecords . Chaque allocation doit être supérieure à zéro (0) ou la fonction échoue avec ERROR_INVALID_PARAMETER.

[out] pcbAlignReservation

Pointeur vers une variable dans laquelle la fonction retourne le nombre d’espaces d’octets alignés sur le secteur à réserver dans le journal, après avoir reçu le nombre d’enregistrements spécifié par cRecords et la taille des réservations spécifiées dans le tableau rgcbReservation .

La valeur retournée dans *pcbAlignReservation est utilisée comme entrée dans AllocReservedLog. Si AllocReservedLog réussit, cette valeur est toujours supérieure à zéro (0). Si AllocReservedLog échoue, la valeur est zéro (0).

Valeur retournée

Si la fonction réussit, la valeur de retour est différente de zéro.

Si la fonction échoue, la valeur de retour est égale à zéro (0). Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError. La liste suivante identifie les codes d’erreur possibles :

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2003 R2 [applications de bureau uniquement]
Plateforme cible Windows
En-tête clfsw32.h
Bibliothèque Clfsw32.lib
DLL Clfsw32.dll

Voir aussi

AllocReservedLog

Fonctions courantes du système de fichiers journaux