Función JetGetErrorInfoW

Artículo
06/13/2023

Se aplica a: Windows | Windows Server

Función JetGetErrorInfoW

La función JetGetErrorInfoW BAS_ del motor de base de datos.

Nota: Esta documentación se basa en una versión preliminar del motor de almacenamiento extensible. Esta información está sujeta a cambios.

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 );

Parámetros

pvContext

Contexto o valor de error para el que se necesita la información de error extendida. El valor pasado depende del valor del parámetro InfoLevel .

pvResult

Puntero a un búfer que recibirá la información. El tipo del búfer depende del valor del parámetro InfoLevel . El autor de la llamada debe configurarse para alinear el búfer correctamente.

cbMax

Tamaño máximo de la estructura pvResult que se pasa.

InfoLevel

El parámetro pvContext especifica el tipo de información que se recuperará para la información o contexto de error. El formato de los datos almacenados en pvResult depende de InfoLevel.

En la tabla siguiente se enumeran los valores posibles para este parámetro.

Valor	Significado
JET_ErrorInfoSpecificErr	pvContext se interpreta como un código de error o JET_ERR, pvResult se interpreta como un JET_ERRINFOBASIC_W, y los campos de la estructura de JET_ERRINFOBASIC_W se rellenan correctamente.

grbit

Reservado.

Valor devuelto

Esta función devuelve el tipo de datos JET_ERR con uno de los códigos de retorno enumerados en la tabla siguiente. Para obtener más información sobre los posibles errores de ESE, vea Extensible Storage Engine Errors and Error Handling Parameters.

Código devuelto	Descripción
JET_errSuccess	La operación se ha completado correctamente.
JET_errInvalidParameter	Uno de los parámetros proporcionados contiene un valor inesperado o contiene un valor que no tiene sentido cuando se combina con el valor de otro parámetro. Esto puede ocurrir para JetGetErrorInfo cuando se produce lo siguiente: El valor del parámetro InfoLevel especificado no es válido. El valor de grbit especificado no es válido. El valor cbMax del parámetro pvResult especificado es menor que el tamaño necesario para la salida de este parámetro InfoLevel. Para InfoLevel = JET_ErrorInfoSpecificErr, el valor de JET_ERR pasado es desconocido para el motor.
JET_errDisabledFunctionality	Si esta SKU de windows no admite esta función, se devolverá este error.

Código devuelto

Descripción

JET_errSuccess

La operación se ha completado correctamente.

JET_errInvalidParameter

Uno de los parámetros proporcionados contiene un valor inesperado o contiene un valor que no tiene sentido cuando se combina con el valor de otro parámetro. Esto puede ocurrir para JetGetErrorInfo cuando se produce lo siguiente:

El valor del parámetro InfoLevel especificado no es válido.
El valor de grbit especificado no es válido.
El valor cbMax del parámetro pvResult especificado es menor que el tamaño necesario para la salida de este parámetro InfoLevel.
Para InfoLevel = JET_ErrorInfoSpecificErr, el valor de JET_ERR pasado es desconocido para el motor.

JET_errDisabledFunctionality

Si esta SKU de windows no admite esta función, se devolverá este error.

Si se ejecuta correctamente, el búfer de salida adecuado para el contexto o valor de error solicitado se establecerá en la información de error extendida solicitada.

Si se produce un error, el estado de los búferes de salida no estará definido.

Observaciones

La función JET_ERRINFOBASIC_W y JET_ERRCAT grupo de constantes contienen documentación sobre la información de error extendida que se devuelve para InfoLevel = JET_ErrorInfoSpecificErr.

Requisitos

Requisito	Value
Cliente	Requiere Windows 8.
Servidor	Requiere Windows 8 Server.
Encabezado	Declarado en Esent.h.
Library	Use ESENT.lib.
Archivo DLL	Requiere ESENT.dll.
Unicode	Nota: Solo se implementa JetGetErrorInfoW (Unicode). Esta API no tiene una versión A (ANSI).

Función JetGetErrorInfoW