Fonction FreeReservedLog (clfsw32.h)
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 |