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

Функция JetGetErrorInfoW

  • Статья

Применимо к: Windows | Windows Server

Функция JetGetErrorInfoW

Функция JetGetErrorInfoW BAS_ ядра СУБД.

Примечание. Эта документация основана на предварительном выпуске подсистемы расширяемого хранилища. Эта информация может быть изменена.

JET_ERR JET_API JetGetErrorInfoW( 
    _In_opt_ void *                      pvContext, 
    _Out_writes_bytes_( cbMax ) void *   pvResult, 
    _In_ unsigned long                   cbMax, 
    _In_ unsigned long                   InfoLevel, 
    _In_ JET_GRBIT                       grbit );

Параметры

pvContext

Контекст или значение ошибки, для которого требуются расширенные сведения об ошибке. Передаваемое значение зависит от значения параметра InfoLevel .

pvResult

Указатель на буфер, который будет получать сведения. Тип буфера зависит от значения параметра InfoLevel . Вызывающий объект должен быть настроен для соответствующего выравнивания буфера.

cbMax

Максимальный размер передаваемой структуры pvResult .

InfoLevel

Тип сведений, которые будут получены для сведений об ошибке или контекста, определяется параметром pvContext . Формат данных, хранящихся в pvResult , зависит от InfoLevel.

В следующей таблице перечислены возможные значения для этого параметра.

Значение

Значение

JET_ErrorInfoSpecificErr

pvContext интерпретируется как код JET_ERR/ошибки, pvResult интерпретируется как JET_ERRINFOBASIC_W, а поля структуры JET_ERRINFOBASIC_W заполняются соответствующим образом.

grbit

Зарезервировано.

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

Эта функция возвращает JET_ERR тип данных с одним из кодов возврата, перечисленных в следующей таблице. Дополнительные сведения о возможных ошибках ESE см. в разделах Ошибки подсистемы расширяемого хранилища и Параметры обработки ошибок.

Код возврата

Описание

JET_errSuccess

Операция выполнена успешно.

JET_errInvalidParameter

Один из предоставленных параметров содержит непредвиденное значение или значение, которое не имеет смысла в сочетании со значением другого параметра. Это может произойти для JetGetErrorInfo , если происходит следующее:

  • Указанное значение параметра InfoLevel недопустимо.

  • Указанное значение grbit недопустимо.

  • Значение cbMax указанного буфера параметра pvResult меньше требуемого размера для выходных данных этого параметра InfoLevel.

  • Для InfoLevel = JET_ErrorInfoSpecificErr переданное JET_ERR значение неизвестно подсистеме.

JET_errDisabledFunctionality

Если этот номер SKU windows не поддерживает эту функцию, будет возвращена эта ошибка.

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

При сбое состояние выходных буферов будет неопределенным.

Комментарии

Функция JET_ERRINFOBASIC_W и группа констант JET_ERRCAT содержат документацию о расширенной информации об ошибке, возвращаемой для InfoLevel = JET_ErrorInfoSpecificErr.

Требования

Требование Значение

Клиент

Требуется Windows 8.

Сервер

Требуется Windows 8 Server.

Верхняя часть

Объявлено в Esent.h.

Библиотека

Используйте ESENT.lib.

DLL

Требуется ESENT.dll.

Юникод

Примечание. Реализована только функция JetGetErrorInfoW (Юникод). Этот API не имеет версии A (ANSI).