Функция CChkSGFiles.ErrTerm

Статья
04/04/2023

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

Предоставляет общее состояние базы данных и проверки журнала, указывающее, были ли успешно проверены все страницы базы данных и журналы.

Важно!

Группы хранения недоступны в Exchange 2013. Для обратной совместимости с базами данных и группами хранения в версиях Exchange, предшествующих Exchange Server 2010, API CHKSGFILES позволяет указать группы хранения. При запуске CHKSGFILES для баз данных Exchange 2013 следует задать пустую строку для параметров, указывающих идентификатор группы хранения.

Vitual ERRErrTerm 
(
    Const ULONGulFlags = NO_FLAGS
);

Параметры

ulFlags

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

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

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

Замечания

Объект CChkSGFiles определяет, были ли проверены все базы данных, зарегистрированные с помощью функции ErrInit . Этот объект использует функцию ErrCheckDbPages для проверки того, что на самом деле проверено то же количество страниц базы данных, определяемое функцией ErrCheckDbHeaders . Если правильное количество страниц в каждой базе данных не проверено, функция ErrTerm возвращает ошибку.

Если количество страниц базы данных, проверенных с помощью ErrCheckDbPages , меньше, чем указано в ErrCheckDbHeaders, эта функция создает ошибку в журнале событий Windows, а ErrTerm возвращает ошибку.

Если количество страниц базы данных, проверенных ErrCheckDbPages , больше, чем указано в ErrCheckDbHeaders, эта функция создает предупреждение в журнале событий Windows, указывающее, что приложение может неоправданно проверять некоторые страницы базы данных более одного раза. Однако в этом случае функция ErrTerm завершается успешно.

Объект CChkSGFiles также определяет, были ли фактически проверены файлы журнала, зарегистрированные в ErrInit . Если не все журналы были успешно проверены, функция ErrTerm возвращает ошибку.

Когда ErrTerm возвращает ошибку, это будет первая обнаруженная ошибка, даже если она проверяет состояние проверки для всех баз данных, зарегистрированных в ErrInit.

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

Требования

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

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

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