Функция JetGetErrorInfoW

Статья
06/13/2023

Применимо к: 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_errSuccess

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

JET_errInvalidParameter

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

Указанное значение параметра InfoLevel недопустимо.
Указанное значение grbit недопустимо.
Значение cbMax указанного буфера параметра pvResult меньше требуемого размера для выходных данных этого параметра InfoLevel.
Для InfoLevel = JET_ErrorInfoSpecificErr переданное JET_ERR значение неизвестно подсистеме.

JET_errDisabledFunctionality

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

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

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

Требования

Требование	Значение
Клиент	Требуется Windows 8.
Сервер	Требуется Windows 8 Server.
Верхняя часть	Объявлено в Esent.h.
Библиотека	Используйте ESENT.lib.
DLL	Требуется ESENT.dll.
Юникод	Примечание. Реализована только функция JetGetErrorInfoW (Юникод). Этот API не имеет версии A (ANSI).

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

Функция JetGetErrorInfoW