Функция функция cchksgfiles. ЕррчеккдбхеадерсCChkSGFiles.ErrCheckDbHeaders function

Применимо к: Exchange Server 2003 | Exchange Server 2007 | Exchange Server 2010 | Exchange Server 2013Applies to: Exchange Server 2003 | Exchange Server 2007 | Exchange Server 2010 | Exchange Server 2013

Проверяет заголовки файлов базы данных, которые были указаны функцией ерринит .Validates the headers of the database files that were specified by the ErrInit function. Эта функция также возвращает размер страницы и количество страниц в каждой из указанных баз данных.This function also returns the page size and number of pages in each of the specified databases.

Vitual ERRErrCheckDbHeaders  
(
        ULONG  * const pcbDbPageSize,
        ULONG  * const pcHeaderPagesPerDb,
        ULONG   const piDbErrorEncountered,
    Const ULONGulFlags = NO_FLAGS
);

ПараметрыParameters

пкбдбпажесизеpcbDbPageSize

Выходной параметр.Output parameter. Размер страницы каждой из указанных баз данных в байтах.The page size of each of the specified databases, in bytes.

пчеадерпажеспердбpcHeaderPagesPerDb

Выходной параметр.Output parameter. Количество страниц в начале каждой заданной базы данных, зарезервированных ядром СУБД для внутреннего использования.The number of pages at the beginning of each specified database that are reserved by the database engine for internal use. Обратите внимание, что не следует передавать страницы заголовков в функцию еррчеккдбпажес для проверки.Note that you should not pass header pages to the ErrCheckDbPages function for validation.

пидберроренкаунтередpiDbErrorEncountered

Выходной параметр.Output parameter. Если возвращаемое значение функции указывает на ошибку, этот параметр будет индексом в массиве ргвсздб [] , переданном функции ерринит .If the return value of the function indicates an error, this parameter will be an index into the rgwszDb[] array passed to the ErrInit function. Элемент индексированного массива представляет базу данных, в которой произошла ошибка.The indexed array element represents the database in which the error was encountered. Если функция не возвращает значение ошибки, значение этого параметра не является допустимым.If the function does not return an error value, this parameter value is invalid.

ulFlagsulFlags

Необязательный входной параметр.Optional input parameter. Это значение зарезервировано для использования в будущем.This value is reserved for future use. Передаваемое значение должно быть равно 0 (нулю).The value passed should be 0 (zero).

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

Эта функция возвращает код ошибки из перечисления функция cchksgfiles. ERR.This function returns an error code from the CChkSGFiles.ERR enumeration.

ПримечанияRemarks

Еррчеккдбхеадерс проверяет, что все базы данных, зарегистрированные в ерринит , имеют одинаковую подпись журнала и размер страницы базы данных.ErrCheckDbHeaders verifies that all databases registered with ErrInit have the same log signature and database page size. Кроме того, можно использовать самое низкое значение параметра женмин и максимальное значение параметра женмакс , чтобы определить набор файлов журнала, необходимых для переноса всех зарегистрированных баз данных в состояние чистого отключения.You can also use the lowest genMin parameter value and the highest genMax parameter value to determine the set of log files that are necessary to bring all of the registered databases to a clean-shutdown state.

Параметр пидберроренкаунтеред задается только при обнаружении ошибки, что определяется ненулевым возвращаемым значением еррчеккдбхеадерс .The piDbErrorEncountered parameter is set only when an error is detected, as indicated by a non-zero ErrCheckDbHeaders return value.

При возникновении ошибки в этой функции в журнал событий ошибок Windows добавляется событие Error.When an error occurs in this function, an error event will be added to the Windows Error event log.

Вы можете вызвать еррчеккдбхеадерс только после вызова ерринит, и его необходимо вызвать перед вызовом еррчеккдбпажес и еррчекклогс.You can call ErrCheckDbHeaders only after calling ErrInit, and you must call it before calling ErrCheckDbPages and ErrCheckLogs.

Если вы используете ЧКСГФИЛЕС в многопоточном приложении, вы должны вызвать функцию еррчеккдбхеадерс в однопотоковой части, и вы можете вызвать ее только один раз для каждого объекта кчекксгфилес .If you're using CHKSGFILES in a multithreaded application, you must call the ErrCheckDbHeaders function in the single-threaded portion, and you can call it only once for each CCheckSGFiles object.

RequirementsRequirements

Exchange 2013 включает только 64-разрядную версию API ЧКСГФИЛЕС.Exchange 2013 only includes a 64-bit version of the CHKSGFILES API.

Учетная запись, под которой выполняется приложение, должна иметь разрешения на чтение для базы данных и файлов журнала, которые необходимо проверить.The account that the application is running under must have read access permissions to the database and log files that are to be checked.