CChkSGFiles.ErrInit-Funktion

Artikel
04/04/2023

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

Initialisiert das CChkSGFiles-Objekt , indem die zu überprüfenden Datenbanken sowie der Pfad und der Basisname der zu überprüfenden Transaktionsprotokolldateien angegeben werden. Anwendungen sollten diese Funktion unmittelbar nach dem erfolgreichen Aufruf der New-Funktion aufrufen.

Vitual ERRErrInit  
(
    Const WCHAR  * const rgwszDb[],
    Const ULONGcDB,
    __in_z const WCHAR  * const wszLogPath,
    __in_z const WCHAR  * const wszBaseName,
    Const ULONGulFlags = NO_FLAGS
);

Parameter

rgwszDb[]

Eingabeparameter. Ein Array, das die zu überprüfenden Datenbanken angibt. Jedes Arrayelement ist eine mit NULL endende Unicode-Zeichenfolge, die den Pfad und Dateinamen einer zu überprüfenden Datenbank enthält.

Cdb

Eingabeparameter. Die Anzahl der gültigen Datenbankpfadelemente im rgwszDb-Array .

wszLogPath

Eingabeparameter. Der vollständige Pfad der zu überprüfenden Transaktionsprotokolldateien in Form einer unicode-Zeichenfolge mit NULL-Terminierung.

wszBaseName

Eingabeparameter. Der aus drei Buchstaben bestehende Basisname der Exchange-Transaktionsprotokolldateien in Form einer Unicode-Zeichenfolge mit NULL-Terminierung.

ulFlags

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

Rückgabewert

Ein Fehlercode aus der ERR-Enumeration .

HinwBemerkungeneise

Die Funktion ErrInit registriert die Datenbanken und Protokolldateien, die überprüft werden sollen. Diese Funktion muss aufgerufen werden, nachdem die New-Funktion aufgerufen wurde, aber bevor eine andere ChkSGFiles-Funktion aufgerufen wird.

Sie müssen alle Datenbanknamen, den Protokolldateipfad und den Basisnamen als mit NULL endende Unicode-Zeichenfolgen angeben.

Sie können nur die Datenbankdateien, nur die Protokolldateien oder sowohl die Datenbank- als auch die Protokolldateien überprüfen. Beim Aufrufen dieser Funktion muss die Anwendung jedoch mindestens eine Entität angeben, die überprüft werden soll. Das Übergeben von 0 (null) für cDB und NULL für wszLogPath gibt einen Fehler zurück.

Wenn der Wert von cDB nicht 0 (null) ist, führt die Übergabe von NULL für rgwszDb zu einem Fehler. Um die Datenbankdateien zu überprüfen, muss die Anwendung die Datenbanknamen angeben.

Wenn NULL für wszBaseName übergeben wird, wszLogPath* aber nicht NULL ist, wird ein Fehler zurückgegeben. Beim Überprüfen von Protokolldateien ist immer ein Basisname der Protokolldatei erforderlich.

Wenn Sie CHKSGFILES in einer Multithreadanwendung verwenden, müssen Sie die ErrInit-Funktion im Singlethread-Teil der Anwendung 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