CChkSGFiles.ErrCheckDbHeaders-Funktion

Artikel
04/04/2023

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

Überprüft die Header der Datenbankdateien, die von der Funktion ErrInit angegeben wurden. Diese Funktion gibt auch die Seitengröße und die Anzahl der Seiten in jeder der angegebenen Datenbanken zurück.

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

Parameter

pcbDbPageSize

Output-Parameter. Die Seitengröße jeder der angegebenen Datenbanken in Bytes.

pcHeaderPagesPerDb

Output-Parameter. Die Anzahl der Seiten am Anfang jeder angegebenen Datenbank, die von der Datenbank-Engine für die interne Verwendung reserviert werden. Beachten Sie, dass Sie Kopfzeilenseiten nicht zur Überprüfung an die ErrCheckDbPages-Funktion übergeben sollten.

piDbErrorEncountered

Output-Parameter. Wenn der Rückgabewert der Funktion auf einen Fehler hinweist, ist dieser Parameter ein Index in das rgwszDb[] -Array, das an die Funktion ErrInit übergeben wird. Das indizierte Arrayelement stellt die Datenbank dar, in der der Fehler aufgetreten ist. Wenn die Funktion keinen Fehlerwert zurückgibt, ist dieser Parameterwert ungültig.

ulFlags

Optionaler Eingabeparameter. Dieser Wert ist für die zukünftige Verwendung reserviert. Der übergebene Wert sollte 0 (null) sein.

Rückgabewert

Diese Funktion gibt einen Fehlercode aus der CChkSGFiles.ERR-Enumeration zurück.

HinwBemerkungeneise

ErrCheckDbHeaders überprüft, ob alle bei ErrInit registrierten Datenbanken die gleiche Protokollsignatur und Datenbankseitengröße haben. Sie können auch den niedrigsten genMin-Parameterwert und den höchsten genMax-Parameterwert verwenden, um den Satz von Protokolldateien zu bestimmen, die erforderlich sind, um alle registrierten Datenbanken in einen zustand des sauberen Herunterfahrens zu versetzen.

Der piDbErrorEncountered-Parameter wird nur festgelegt, wenn ein Fehler erkannt wird, wie durch einen ErrCheckDbHeaders-Rückgabewert ungleich 0 angegeben.

Wenn in dieser Funktion ein Fehler auftritt, wird dem Windows-Fehlerereignisprotokoll ein Fehlerereignis hinzugefügt.

Sie können ErrCheckDbHeaders nur nach dem Aufruf von ErrInit aufrufen, und Sie müssen es vor dem Aufrufen von ErrCheckDbPages und ErrCheckLogs aufrufen.

Wenn Sie CHKSGFILES in einer Multithreadanwendung verwenden, müssen Sie die Funktion ErrCheckDbHeaders im Singlethreaded-Teil aufrufen, und Sie können sie nur einmal für jedes CCheckSGFiles-Objekt aufrufen.

Anforderungen

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

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

Freigeben über