Fonction CChkSGFiles.ErrInit

Article
04/04/2023

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

Initialise l’objet CChkSGFiles en spécifiant les bases de données à vérifier et le chemin d’accès et le nom de base des fichiers journaux des transactions à vérifier. Les applications doivent appeler cette fonction immédiatement après avoir correctement appelé la fonction New .

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

Parameters

rgwszDb[]

Paramètre d’entrée. Tableau qui spécifie les bases de données à vérifier. Chaque élément de tableau est une chaîne Unicode terminée par null qui contient le chemin d’accès et le nom de fichier d’une base de données à vérifier.

cDB

Paramètre d’entrée. Nombre d’éléments de chemin de base de données valides dans le tableau rgwszDb .

wszLogPath

Paramètre d’entrée. Chemin d’accès complet des fichiers journaux des transactions à vérifier, sous la forme d’une chaîne Unicode terminée par null.

wszBaseName

Paramètre d’entrée. Nom de base à trois lettres des fichiers journaux des transactions Exchange, sous la forme d’une chaîne Unicode terminée par null.

ulFlags

Paramètre d’entrée facultatif. Cette valeur est réservée pour une utilisation ultérieure. La valeur transmise par ce paramètre doit être 0 (zéro).

Valeur renvoyée

Code d’erreur de l’énumération ERR .

Remarques

La fonction ErrInit inscrit les bases de données et les fichiers journaux à vérifier. Cette fonction doit être appelée après l’appel de la fonction New , mais avant l’appel de toute autre fonction ChkSGFiles .

Vous devez fournir tous les noms de base de données, le chemin du fichier journal et le nom de base sous forme de chaînes Unicode terminées par null.

Vous pouvez vérifier uniquement les fichiers de base de données, uniquement les fichiers journaux, ou les fichiers de base de données et les fichiers journaux. Toutefois, lors de l’appel de cette fonction, l’application doit spécifier au moins une entité à vérifier. Le fait de passer 0 (zéro) pour cDB et NULL pour wszLogPath renvoie une erreur.

Si la valeur de cDB est différente de 0 (zéro), la transmission de la valeur NULL pour rgwszDb génère une erreur. Pour vérifier les fichiers de base de données, l’application doit fournir les noms de base de données.

Si null est passé pour wszBaseName , mais que wszLogPath* n’est pas NULL, une erreur est retournée. Un nom de base de fichier journal est toujours requis lors de la vérification des fichiers journaux.

Si vous utilisez CHKSGFILES dans une application multithread, vous devez appeler la fonction ErrInit dans la partie monothread de l’application, et vous ne pouvez l’appeler qu’une seule fois pour chaque objet CCheckSGFiles .

Conditions requises

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

Le compte sous lequel l’application s’exécute doit disposer d’autorisations d’accès en lecture à la base de données et aux fichiers journaux à vérifier.

Partager via