Функция CChkSGFiles.ErrInit

Статья
04/04/2023

Область применения: Exchange Server 2003 | | Exchange Server 2007 г. | Exchange Server 2010 г. Exchange Server 2013 г.

Инициализирует объект 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, которая содержит путь и имя файла проверяемой базы данных.

Cdb

Входной параметр. Число допустимых элементов пути к базе данных в массиве rgwszDb .

wszLogPath

Входной параметр. Полный путь к проверяемых файлам журнала транзакций в виде строки Юникода, завершаемой null.

wszBaseName

Входной параметр. Трехбуквовое базовое имя файлов журнала транзакций Exchange в виде строки Юникода, завершаемой null.

ulFlags

Необязательный входной параметр. Это значение зарезервировано для использования в будущем. Значение, передаваемое этим параметром, должно быть равно 0 (ноль).

Возвращаемое значение

Код ошибки из перечисления ERR .

Замечания

Функция ErrInit регистрирует проверяемые базы данных и файлы журналов. Эта функция должна вызываться после вызова функции New , но до вызова любой другой функции ChkSGFiles .

Необходимо указать все имена баз данных, путь к файлу журнала и базовое имя в виде строк Юникода с завершением NULL.

Вы можете проверить только файлы базы данных, только файлы журналов или файлы базы данных и журналов. Однако при вызове этой функции приложение должно указать по крайней мере одну проверяемую сущность. Передача 0 (ноль) для cDB и NULL для wszLogPath вернет ошибку.

Если значение cDB отличается от 0 (ноль), передача NULL для rgwszDb приведет к ошибке. Чтобы проверить файлы базы данных, приложение должно предоставить имена баз данных.

Если значение NULL передается для wszBaseName , но wszLogPath* не равно NULL, возвращается ошибка. При проверке файлов журнала всегда требуется базовое имя файла журнала.

Если вы используете CHKSGFILES в многопоточном приложении, необходимо вызвать функцию ErrInit в однопоточной части приложения и вызвать ее только один раз для каждого объекта CCheckSGFiles .

Требования

Exchange 2013 включает только 64-разрядную версию API CHKSGFILES.

Учетная запись, в котором выполняется приложение, должна иметь разрешения на доступ на чтение к проверяемой базе данных и файлам журнала.

Поделиться через