Compartir por

CDBErrorInfo (Clase)

  • Artigo

Proporciona compatibilidad con el procesamiento de errores OLE DB mediante la interfaz IErrorRecords de OLE DB.

Sintaxis

class CDBErrorInfo

Requisitos

Encabezado: atldbcli.h

Miembros

Métodos

Nombre Descripción
GetAllErrorInfo Devuelve toda la información de error contenida en un registro de error.
GetBasicErrorInfo Llama a IErrorRecords::GetBasicErrorInfo para devolver información básica sobre el error especificado.
GetCustomErrorObject Llama a IErrorRecords::GetCustomErrorObject para devolver un puntero a una interfaz en un objeto de error personalizado.
GetErrorInfo Llama a IErrorRecords::GetErrorInfo para devolver un puntero de interfaz IErrorInfo al registro especificado.
GetErrorParameters Llama a IErrorRecords::GetErrorParameters para devolver los parámetros de error.
GetErrorRecords Obtiene registros de error para el objeto especificado.

Comentarios

Esta interfaz devuelve uno o varios registros de error al usuario. Llame primero a CDBErrorInfo::GetErrorRecords para obtener un recuento de registros de error. A continuación, llame a una de las funciones de acceso, como CDBErrorInfo::GetAllErrorInfo, para recuperar información de error para cada registro.

CDBErrorInfo::GetAllErrorInfo

Devuelve todos los tipos de información de error contenida en un registro de error.

Sintaxis

HRESULT GetAllErrorInfo(ULONG ulRecordNum,
   LCID lcid,  BSTR* pbstrDescription,
   BSTR* pbstrSource = NULL,
   GUID* pguid = NULL,
   DWORD* pdwHelpContext = NULL,
   BSTR* pbstrHelpFile = NULL) const throw();

Parámetros

ulRecordNum
[in] Número de base cero del registro para el que se va a devolver información de error.

lcid
[in] Identificador de configuración regional de la información de error que se va a devolver.

pbstrDescription
[out] Puntero a una descripción de texto del error o NULL si no se admite la configuración regional. Vea la sección Comentarios.

pbstrSource
[out] Puntero a una cadena que contiene el nombre del componente que generó el error.

pguid
[out] Puntero al GUID de la interfaz que definió el error.

pdwHelpContext
[out] Puntero al identificador de contexto de ayuda para el error.

pbstrHelpFile
[out] Puntero a una cadena que contiene la ruta de acceso al archivo de ayuda que describe el error.

Valor devuelto

S_OK si se ejecuta correctamente. Vea IErrorRecords::GetErrorInfo en la Referencia del programador de OLE DB para ver otros valores devueltos.

Comentarios

El valor de salida de pbstrDescription se obtiene internamente llamando a IErrorInfo::GetDescription, que establece el valor en NULL si no se admite la configuración regional, o si se cumplen las dos condiciones siguientes:

  1. el valor de lcid no es inglés de EE. UU. y

  2. el valor de lcid NO es igual al valor devuelto por GetUserDefaultLCID.

CDBErrorInfo::GetBasicErrorInfo

Llama a IErrorRecords::GetBasicErrorInfo para devolver información básica sobre el error, como el código de retorno y el número de error específico del proveedor.

Sintaxis

HRESULT GetBasicErrorInfo(ULONG ulRecordNum,
   ERRORINFO* pErrorInfo) const throw();

Parámetros

Vea IErrorRecords::GetBasicErrorInfo en la Referencia del programador de OLE DB.

Valor devuelto

Un HRESULT estándar.

CDBErrorInfo::GetCustomErrorObject

Llama a IErrorRecords::GetCustomErrorObject para devolver un puntero a una interfaz en un objeto de error personalizado.

Sintaxis

HRESULT GetCustomErrorObject(ULONG ulRecordNum,
   REFIID riid,IUnknown** ppObject) const throw();

Parámetros

Vea IErrorRecords::GetCustomErrorObject en la Referencia del programador de OLE DB.

Valor devuelto

Un HRESULT estándar.

CDBErrorInfo::GetErrorInfo

Llama a IErrorRecords::GetErrorInfo para devolver un puntero de interfaz IErrorInfo al registro especificado.

Sintaxis

HRESULT GetErrorInfo(ULONG ulRecordNum,
   LCID lcid,IErrorInfo** ppErrorInfo) const throw();

Parámetros

Vea IErrorRecords::GetErrorInfo en la Referencia del programador de OLE DB.

Valor devuelto

Un HRESULT estándar.

CDBErrorInfo::GetErrorParameters

Llama a IErrorRecords::GetErrorParameters para devolver los parámetros de error.

Sintaxis

HRESULT GetErrorParameters(ULONG ulRecordNum,
   DISPPARAMS* pdispparams) const throw();

Parámetros

Vea IErrorRecords::GetErrorParameters en la Referencia del programador de OLE DB.

Valor devuelto

Un HRESULT estándar.

CDBErrorInfo::GetErrorRecords

Obtiene registros de error para el objeto especificado.

Sintaxis

HRESULT GetErrorRecords(IUnknown* pUnk,
   const IID& iid,
   ULONG* pcRecords) throw();

HRESULT GetErrorRecords(ULONG* pcRecords) throw();

Parámetros

pUnk
[in] Interfaz al objeto para el que se van a obtener registros de error.

iid
[in] IID de la interfaz asociada al error.

pcRecords
[out] Puntero al recuento (basado en uno) de los registros de error.

Valor devuelto

Un HRESULT estándar.

Comentarios

Utilice la primera forma de la función si desea comprobar de qué interfaz obtener la información de error. En caso contrario, utilice la segunda forma.

Consulte también

DBViewer
Plantillas de consumidor OLE DB
Referencia de plantillas de consumidor OLE DB