Fonction FreeReservedLog (clfsw32.h)

  • Article

Réduit le nombre d’enregistrements de journal réservés dans une zone de marshaling en appelant ReserveAndAppendLog, ReserveAndAppendLogAligned ou AllocReservedLog. À l’aide de cette fonction, les clients peuvent libérer un ensemble agrégé d’enregistrements et d’octets réservés dans la zone de marshaling.

Syntaxe

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

Paramètres

[in, out] pvMarshal

Pointeur vers le contexte de marshaling opaque alloué à l’aide de la fonction CreateLogMarshallingArea .

[in] cReservedRecords

Nombre d’enregistrements réservés à libérer.

Si le nombre d’octets de l’ajustement dans pcbAdjustment est positif, cReservedRecords correspond au nombre total d’enregistrements réservés qui restent après l’ajustement. Sinon, ce paramètre spécifie le nombre d’enregistrements à soustraire du nombre actuel d’enregistrements réservés, mais ne peut jamais dépasser le nombre d’enregistrements réservés.

[in, out] pcbAdjustment

Nombre d’octets d’espace de réservation affecté par l’ajustement.

En entrée, si ce nombre est positif, il spécifie la taille restante totale de l’espace réservé après l’ajustement. Si ce paramètre est négatif, sa valeur absolue est le nombre d’octets à libérer.

Cette valeur est généralement un agrégat de l’espace réservé réel qui est retourné dans un appel précédent à ce qui suit :

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. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError. La liste suivante identifie les codes d’erreur possibles :

Remarques

Lorsque vous réservez des enregistrements, vous réservez une taille spécifique. Lorsque vous libérez ces enregistrements, vous devez libérer la même taille.

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

Fonctions courantes du système de fichiers journaux