Fonction CChkSGFiles.PgnoFromFileOffset

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

Retourne le numéro de page de base de données logique qui correspond à l’index d’octet spécifié dans le fichier de base de données physique. Si le décalage de fichier n’est pas valide ou si la fonction ErrCheckDbHeaders n’a pas été appelée pour les bases de données, cette fonction retourne 0 (zéro).

Vitual ULONGPgnoFromFileOffset  
(
    Const ULONGLONGibFileOffset
);

Parameters

ibFileOffset

Paramètre d’entrée. Décalage dans un fichier de base de données, en octets.

Valeur renvoyée

Numéro de page logique du fichier de base de données qui inclut le décalage spécifié.

Remarques

Si le paramètre ibFileOffset n’est pas valide, la fonction PgnoFromFileOffset retourne 0 (zéro).

PgnoFromFileOffset retourne également 0 (zéro) si vous n’avez pas appelé la fonction ErrCheckDbHeaders sur l’instance CCheckSGFiles . 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.

Vous devez utiliser PgnoFromFileOffset pour renseigner les éléments de structure PAGE_INFO en préparation de l’appel d’ErrCheckDbPages. Le paramètre rgPageInfo sur ErrCheckDbPages nécessite que chaque élément du tableau soit une structure PAGE_INFO , avec les valeurs de membre ulPgno correctement initialisées.

Si vous utilisez CHKSGFILES dans une application multithread, vous pouvez appeler la fonction PgnoFromFileOffset dans la partie multithread de l’application. Notez que vous appelez généralement cette fonction plusieurs fois pour chaque base de données vérifiée.

Conditions requises

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

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 qui doivent être vérifiés.