Fonction fonction cchksgfiles. PgnoFromFileOffsetCChkSGFiles.PgnoFromFileOffset 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

Renvoie le numéro de page de base de données logique correspondant à l’index d’octet spécifié dans le fichier de base de données physique.Returns the logical database page number that corresponds to the specified byte index in the physical database file. Si le décalage du fichier n’est pas valide ou si la fonction ErrCheckDbHeaders n’a pas été appelée pour les bases de données, cette fonction renvoie la valeur 0 (zéro).If the file offset is invalid, or if the ErrCheckDbHeaders function has not been called for the databases, this function returns 0 (zero).

Vitual ULONGPgnoFromFileOffset  
(
    Const ULONGLONGibFileOffset
);

ParamètresParameters

ibFileOffsetibFileOffset

Paramètre d’entrée.Input parameter. Offset dans un fichier de base de données, en octets.The offset into a database file, in bytes.

Valeur renvoyéeReturn value

Numéro de page logique du fichier de base de données qui inclut le décalage spécifié.The database file's logical page number that includes the specified offset.

RemarquesRemarks

Si le paramètre ibFileOffset n’est pas valide, la fonction PgnoFromFileOffset renvoie 0 (zéro).If the ibFileOffset parameter is invalid, the PgnoFromFileOffset function returns 0 (zero).

PgnoFromFileOffset renvoie également 0 (zéro) si vous n’avez pas appelé la fonction ErrCheckDbHeaders sur l’instance CCheckSGFiles .PgnoFromFileOffset also returns 0 (zero) if you haven't called the ErrCheckDbHeaders function on the CCheckSGFiles instance. Vous devez appeler ErrCheckDbHeaders pour initialiser la taille de la page de base de données et le nombre de pages allouées aux en-têtes de base de données.You must call ErrCheckDbHeaders to initialize the database page size and number of pages allocated to database headers.

Vous devez utiliser PgnoFromFileOffset pour remplir les éléments de structure d' ** _ informations** en préparation à l’appel de ErrCheckDbPages.You should use PgnoFromFileOffset to fill in the PAGE_INFO structure elements in preparation for calling ErrCheckDbPages. Le paramètre rgPageInfo de ErrCheckDbPages exige que chaque élément du tableau soit une structure PAGE_INFO , avec les valeurs de membre ulPgno correctement initialisées.The rgPageInfo parameter to ErrCheckDbPages requires that each element in the array be a PAGE_INFO structure, with the ulPgno member values correctly initialized.

Si vous utilisez CHKSGFILES dans une application multithread, vous pouvez appeler la fonction PgnoFromFileOffset dans la partie multithread de l’application.If you're using CHKSGFILES in a multithreaded application, you can call the PgnoFromFileOffset function in the multithreaded portion of the application. Notez que vous appelez généralement cette fonction plusieurs fois pour chaque base de données vérifiée.Note that you would typically call this function multiple times for each database being checked.

Configuration requiseRequirements

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

Le compte sous lequel l’application s’exécute doit disposer d’une autorisation de lecture sur la base de données et les fichiers journaux à vérifier.The account that the application is running under must have read permission to the database and log files that are to be checked.