GetLogFileInformation, fonction (clfsw32.h)
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 |