Fonction fonction cchksgfiles. ErrCheckDbHeadersCChkSGFiles.ErrCheckDbHeaders function

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

Valide les en-têtes des fichiers de base de données qui ont été spécifiés par la fonction ErrInit .Validates the headers of the database files that were specified by the ErrInit function. Cette fonction renvoie également la taille de la page et le nombre de pages dans chacune des bases de données spécifiées.This function also returns the page size and number of pages in each of the specified databases.

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

ParamètresParameters

pcbDbPageSizepcbDbPageSize

Paramètre de sortie.Output parameter. Taille de page de chacune des bases de données spécifiées, en octets.The page size of each of the specified databases, in bytes.

pcHeaderPagesPerDbpcHeaderPagesPerDb

Paramètre de sortie.Output parameter. 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 à des fins d’utilisation interne.The number of pages at the beginning of each specified database that are reserved by the database engine for internal use. Notez que vous ne devez pas transmettre de pages d’en-tête à la fonction ErrCheckDbPages pour la validation.Note that you should not pass header pages to the ErrCheckDbPages function for validation.

piDbErrorEncounteredpiDbErrorEncountered

Paramètre de sortie.Output parameter. Si la valeur renvoyée par la fonction indique une erreur, ce paramètre correspond à un index dans le tableau rgwszDb [] passé à la fonction ErrInit .If the return value of the function indicates an error, this parameter will be an index into the rgwszDb[] array passed to the ErrInit function. L’élément de tableau indexé représente la base de données dans laquelle l’erreur a été rencontrée.The indexed array element represents the database in which the error was encountered. Si la fonction ne renvoie pas de valeur d’erreur, la valeur de ce paramètre n’est pas valide.If the function does not return an error value, this parameter value is invalid.

ulFlagsulFlags

Paramètre d’entrée facultatif.Optional input parameter. Cette valeur est réservée à un usage ultérieur.This value is reserved for future use. La valeur transmise doit être 0 (zéro).The value passed should be 0 (zero).

Valeur renvoyéeReturn value

Cette fonction renvoie un code d’erreur à partir de l' énumération fonction cchksgfiles. err.This function returns an error code from the CChkSGFiles.ERR enumeration.

RemarquesRemarks

ErrCheckDbHeaders vérifie que toutes les bases de données enregistrées avec ErrInit ont la même signature de journal et la même taille de page de base de données.ErrCheckDbHeaders verifies that all databases registered with ErrInit have the same log signature and database page size. Vous pouvez également utiliser la valeur de paramètre genMin la plus faible et la valeur du paramètre genMax la plus élevée pour déterminer le jeu de fichiers journaux nécessaires pour mettre toutes les bases de données enregistrées à un état d’arrêt correct.You can also use the lowest genMin parameter value and the highest genMax parameter value to determine the set of log files that are necessary to bring all of the registered databases to a clean-shutdown state.

Le paramètre piDbErrorEncountered est défini uniquement lorsqu’une erreur est détectée, comme indiqué par une valeur de retour différente de zéro ErrCheckDbHeaders .The piDbErrorEncountered parameter is set only when an error is detected, as indicated by a non-zero ErrCheckDbHeaders return value.

Lorsqu’une erreur se produit dans cette fonction, un événement d’erreur est ajouté au journal des événements d’erreurs de Windows.When an error occurs in this function, an error event will be added to the Windows Error event log.

Vous ne pouvez appeler ErrCheckDbHeaders qu’après avoir appelé ErrInit, et vous devez l’appeler avant d’appeler ErrCheckDbPages et ErrCheckLogs.You can call ErrCheckDbHeaders only after calling ErrInit, and you must call it before calling ErrCheckDbPages and ErrCheckLogs.

Si vous utilisez CHKSGFILES dans une application multithread, vous devez appeler la fonction ErrCheckDbHeaders dans la partie à thread unique, et vous ne pouvez l’appeler qu’une seule fois pour chaque objet CCheckSGFiles .If you're using CHKSGFILES in a multithreaded application, you must call the ErrCheckDbHeaders function in the single-threaded portion, and you can call it only once for each CCheckSGFiles object.

Configuration requiseRequirements

Exchange 2013 inclut uniquement une version 64 bits de l’API CHKSGFILES.Exchange 2013 only includes a 64-bit version of the CHKSGFILES API.

Le compte sous lequel l’application s’exécute doit disposer d’autorisations d’accès en lecture à la base de données et des fichiers journaux à vérifier.The account that the application is running under must have read access permissions to the database and log files that are to be checked.