Fonction CChkSGFiles.ErrCheckDbHeaders

Article
04/04/2023

S’applique à : | Exchange Server 2003 Exchange Server 2007 | | Exchange Server 2010 Exchange Server 2013

Valide les en-têtes des fichiers de base de données spécifiés par la fonction ErrInit . Cette fonction retourne également la taille de page et le nombre de pages dans chacune des bases de données spécifiées.

Vitual ERRErrCheckDbHeaders  
(
        ULONG  * const pcbDbPageSize,
        ULONG  * const pcHeaderPagesPerDb,
        ULONG   const piDbErrorEncountered,
    Const ULONGulFlags = NO_FLAGS
);

Parameters

pcbDbPageSize

Paramètre de sortie. Taille de page de chacune des bases de données spécifiées, en octets.

pcHeaderPagesPerDb

Paramètre de sortie. Nombre de pages au début de chaque base de données spécifiée qui sont réservées par le moteur de base de données pour une utilisation interne. Notez que vous ne devez pas passer de pages d’en-tête à la fonction ErrCheckDbPages pour validation.

piDbErrorEncountered

Paramètre de sortie. Si la valeur de retour de la fonction indique une erreur, ce paramètre est un index dans le tableau rgwszDb[] passé à la fonction ErrInit . L’élément de tableau indexé représente la base de données dans laquelle l’erreur a été rencontrée. Si la fonction ne retourne pas de valeur d’erreur, cette valeur de paramètre n’est pas valide.

ulFlags

Paramètre d’entrée facultatif. Cette valeur est réservée pour une utilisation ultérieure. La valeur passée doit être 0 (zéro).

Valeur renvoyée

Cette fonction retourne un code d’erreur à partir de l’énumération CChkSGFiles.ERR.

Remarques

ErrCheckDbHeaders vérifie que toutes les bases de données inscrites avec ErrInit ont la même signature de journal et la même taille de page de base de données. Vous pouvez également utiliser la valeur de paramètre genMin la plus faible et la valeur de paramètre genMax la plus élevée pour déterminer l’ensemble des fichiers journaux nécessaires pour mettre toutes les bases de données inscrites à l’état d’arrêt propre.

Le paramètre piDbErrorEncountered est défini uniquement lorsqu’une erreur est détectée, comme indiqué par une valeur de retour ErrCheckDbHeaders différente de zéro.

Lorsqu’une erreur se produit dans cette fonction, un événement d’erreur est ajouté au journal des événements des erreurs Windows.

Vous pouvez appeler ErrCheckDbHeaders uniquement après avoir appelé ErrInit, et vous devez l’appeler avant d’appeler ErrCheckDbPages et ErrCheckLogs.

Si vous utilisez CHKSGFILES dans une application multithread, vous devez appeler la fonction ErrCheckDbHeaders dans la partie monothread, et vous ne pouvez l’appeler qu’une seule fois pour chaque objet CCheckSGFiles .

Conditions requises

Exchange 2013 inclut uniquement une version 64 bits de l’API CHKSGFILES.

Le compte sous lequel l’application s’exécute doit disposer d’autorisations d’accès en lecture à la base de données et aux fichiers journaux à vérifier.

Partager via