CChkSGFiles.PgnoFromFileOffset-Funktion

Gilt für: Exchange Server 2003 | Exchange Server 2007 | Exchange Server 2010 | Exchange Server 2013

Gibt die Seitenzahl der logischen Datenbank zurück, die dem angegebenen Byteindex in der physischen Datenbankdatei entspricht. Wenn der Dateioffset ungültig ist oder die ErrCheckDbHeaders-Funktion für die Datenbanken nicht aufgerufen wurde, gibt diese Funktion 0 (null) zurück.

Vitual ULONGPgnoFromFileOffset  
(
    Const ULONGLONGibFileOffset
);

Parameter

ibFileOffset

Eingabeparameter. Der Offset in einer Datenbankdatei in Bytes.

Rückgabewert

Die logische Seitenzahl der Datenbankdatei, die den angegebenen Offset enthält.

Hinweise

Wenn der ibFileOffset-Parameter ungültig ist, gibt die PgnoFromFileOffset-Funktion 0 (null) zurück.

PgnoFromFileOffset gibt auch 0 (null) zurück, wenn Sie die Funktion ErrCheckDbHeaders im CCheckSGFiles-instance nicht aufgerufen haben. Sie müssen ErrCheckDbHeaders aufrufen, um die Datenbankseitengröße und die Anzahl der Seiten zu initialisieren, die Datenbankheadern zugeordnet sind.

Sie sollten PgnoFromFileOffset verwenden, um die PAGE_INFO Strukturelemente in Vorbereitung auf den Aufruf von ErrCheckDbPages auszufüllen. Der rgPageInfo-Parameter für ErrCheckDbPages erfordert, dass jedes Element im Array eine PAGE_INFO Struktur ist, wobei die ulPgno-Memberwerte ordnungsgemäß initialisiert sind.

Wenn Sie CHKSGFILES in einer Multithreadanwendung verwenden, können Sie die PgnoFromFileOffset-Funktion im Multithreadteil der Anwendung aufrufen. Beachten Sie, dass Sie diese Funktion in der Regel mehrmals für jede datenbank aufrufen würden, die überprüft wird.

Anforderungen

Exchange Server 2013 enthält nur eine 64-Bit-Version der CHKSGFILES-API.

Das Konto, unter dem die Anwendung ausgeführt wird, muss über Leseberechtigungen für die datenbank- und protokolldateien verfügen, die überprüft werden sollen.