GetLogFileInformation, fonction (clfsw32.h)

  • Article

Retourne une mémoire tampon qui contient des métadonnées sur un journal spécifié et son état actuel, qui est défini par la structure CLFS_INFORMATION .

Les données obtenues reflètent l’état du journal uniquement au moment où l’appel est effectué. En règle générale, un client peut continuer à mettre en cache et à utiliser des champs de cette structure jusqu’à la prochaine fois qu’il ajoute des enregistrements ou écrit sa zone de redémarrage. À ce moment-là, une partie de l’information devient obsolète.

Syntaxe

CLFSUSER_API BOOL GetLogFileInformation(
  [in]      HANDLE            hLog,
  [in, out] PCLFS_INFORMATION pinfoBuffer,
  [in, out] PULONG            cbBuffer
);

Paramètres

[in] hLog

Handle d’un journal ouvert obtenu à partir d’un appel réussi à CreateLogFile.

Le handle de journal peut faire référence à un journal dédié ou multiplexé.

[in, out] pinfoBuffer

Pointeur vers une structure de CLFS_INFORMATION allouée par l’utilisateur qui reçoit les métadonnées du journal.

[in, out] cbBuffer

Pointeur vers une variable qui, en entrée, spécifie la taille, en octets, de la mémoire tampon de métadonnées pointée par pinfoBuffer.

Sur la sortie, il spécifie le nombre d’octets qui sont réellement copiés dans pinfoBuffer.

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 :

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

CLFS_INFORMATION

Fonctions courantes du système de fichiers journaux

CreateLogFile

Obtention du LSN suivant