Fonction ClfsReadPreviousRestartArea (wdm.h)

  • Article

La routine ClfsReadPreviousRestartArea lit l’enregistrement de redémarrage précédent par rapport à l’enregistrement actif dans un contexte de lecture.

Syntaxe

CLFSUSER_API NTSTATUS ClfsReadPreviousRestartArea(
  [in]  PVOID     pvReadContext,
  [out] PVOID     *ppvRestartBuffer,
  [out] PULONG    pcbRestartBuffer,
  [out] PCLFS_LSN plsnRestart
);

Paramètres

[in] pvReadContext

Pointeur vers un contexte de lecture obtenu par un appel précédent à ClfsReadRestartArea.

[out] ppvRestartBuffer

Pointeur vers une variable qui reçoit un pointeur vers la mémoire tampon de données de l’enregistrement de redémarrage lu.

[out] pcbRestartBuffer

Pointeur vers une variable de type ULONG qui reçoit la taille, en octets, de la mémoire tampon pointée par *ppvRestartBuffer. Il s’agit de la longueur de la mémoire tampon de données de l’enregistrement de redémarrage lu.

[out] plsnRestart

Pointeur vers une structure CLFS_LSN qui reçoit le LSN précédent de l’enregistrement de redémarrage lu.

Valeur retournée

ClfsReadPreviousRestartArea retourne STATUS_SUCCESS si elle réussit ; sinon, il retourne l’un des codes d’erreur définis dans Ntstatus.h. S’il n’existe aucune zone de redémarrage précédente, la valeur de retour est STATUS_LOG_START_OF_LOG.

Remarques

Pour obtenir une explication des concepts et de la terminologie CLFS, consultez Common Log File System.

Pour plus d’informations sur la lecture d’enregistrements à partir de flux CLFS, consultez Lecture d’enregistrements de données à partir d’un Stream CLFS et Lecture des enregistrements de redémarrage à partir d’un Stream CLFS.

Les contextes de lecture ne sont pas thread-safe. Les clients sont responsables de la sérialisation de l’accès aux contextes de lecture.

Les clients ajoutent des enregistrements de redémarrage à un journal CLFS en appelant ClfsWriteRestartArea.

Avec la routine ReadPreviousLogRestartArea , les clients peuvent implémenter une forme de point de contrôle flou. Par exemple, l’état du point de contrôle peut se composer des enregistrements de journal délimités par au moins deux enregistrements de redémarrage.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Disponible dans Windows Server 2003 R2, Windows Vista et versions ultérieures de Windows.
Plateforme cible Desktop (Expérience utilisateur)
En-tête wdm.h (inclure Wdm.h)
Bibliothèque Clfs.lib
DLL Clfs.sys
IRQL <= APC_LEVEL

Voir aussi

CLFS_LSN

ClfsReadRestartArea

ClfsWriteRestartArea