通过

CChkSGFiles.ErrInit 函数

  • 项目

适用于：Exchange Server 2003 |Exchange Server 2007 |Exchange Server 2010 |2013 Exchange Server

通过指定要检查的数据库以及要检查的事务日志文件的路径和基名称来初始化 CChkSGFiles 对象。 应用程序应在成功调用 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
);

参数

rgwszDb[]

输入参数。 指定要检查的数据库的数组。 每个数组元素都是以 null 结尾的 Unicode 字符串，其中包含要检查的数据库的路径和文件名。

cDB

输入参数。 rgwszDb 数组中的有效数据库路径元素数。

wszLogPath

输入参数。 要检查的事务日志文件的完整路径，形式为以 null 结尾的 Unicode 字符串。

wszBaseName

输入参数。 Exchange 事务日志文件的三个字母基名称，以 null 结尾的 Unicode 字符串形式。

ulFlags

可选输入参数。 此值保留供将来使用。 此参数传递的值应为 0 (零) 。

返回值

ERR 枚举中的错误代码。

备注

ErrInit 函数注册要检查的数据库和日志文件。 必须在调用 New 函数之后，但在调用任何其他 ChkSGFiles 函数之前调用此函数。

必须将所有数据库名称、日志文件路径和基名称作为以 null 结尾的 Unicode 字符串提供。

只能检查数据库文件、日志文件或数据库和日志文件。 但是，调用此函数时，应用程序必须指定要检查的至少一个实体。 为 cDB 传递 0 (零) ，为 wszLogPath 传递 NULL 将返回错误。

如果 cDB 的值不是 0 (零) ，则为 rgwszDb 传递 NULL 将导致错误。 若要检查数据库文件，应用程序必须提供数据库名称。

如果为 wszBaseName 传递 NULL，但 wszLogPath* 不为 NULL，则将返回错误。 检查日志文件时，始终需要日志文件基名称。

如果在多线程应用程序中使用 CHKSGFILES，则必须在应用程序的单线程部分调用 ErrInit 函数，并且只能为每个 CCheckSGFiles 对象调用一次。

要求

Exchange 2013 仅包含 64 位版本的 CHKSGFILES API。

运行应用程序的帐户必须对要检查的数据库和日志文件具有读取访问权限。