Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
Devuelve un puntero a una estructura SSERRORINFO del proveedor OLE DB de SQL Server Native Client que contiene los detalles del error de SQL Server.
Sintaxis
HRESULT GetErrorInfo(
SSERRORINFO**ppSSErrorInfo,
OLECHAR**ppErrorStrings);
Argumentos
ppSSErrorInfo[out]
Puntero a una estructura SSERRORINFO. Si se produce un error en el método o no hay información de SQL Server asociada al error, el proveedor no asigna ninguna memoria y garantiza que el argumento ppSSErrorInfo sea un puntero nulo en la salida.
ppErrorStrings[out]
Puntero a un puntero de cadena de caracteres Unicode. Si se produce un error en el método o no hay información de SQL Server asociada a un error, el proveedor no asigna ninguna memoria y garantiza que el argumento ppErrorStrings sea un puntero nulo en la salida. Al liberar el argumento ppErrorStrings con el método IMalloc::Free , se liberan los tres miembros de cadena individuales de la estructura SSERRORINFO devuelta, ya que la memoria se asigna en un bloque.
Valores de código de retorno
S_OK
El método se realizó correctamente.
E_INVALIDARG
El argumento ppSSErrorInfo o ppErrorStrings era NULL.
E_MEMORIA_INSUFICIENTE
El proveedor OLE DB de SQL Server Native Client no pudo asignar memoria suficiente para completar la solicitud.
Observaciones
El proveedor OLE DB de SQL Server Native Client asigna memoria para las cadenas SSERRORINFO y OLECHAR devueltas a través de los punteros pasados por el consumidor. El consumidor debe desasignar esta memoria mediante el método IMalloc::Free cuando ya no requiera acceso a los datos de error.
La estructura SSERRORINFO se define de la siguiente manera:
typedef struct tagSSErrorInfo
{
LPOLESTR pwszMessage;
LPOLESTR pwszServer;
LPOLESTR pwszProcedure;
LONG lNative;
BYTE bState;
BYTE bClass;
WORD wLineNumber;
}
SSERRORINFO;
| Miembro | Descripción |
|---|---|
| pwszMessage | Mensaje de error de SQL Server. El mensaje se devuelve a través del método IErrorInfo::GetDescription . |
| pwszServer | Nombre de la instancia de SQL Server en la que se produjo el error. |
| pwszProcedure | Nombre del procedimiento almacenado que genera el error si se produjo el error en un procedimiento almacenado; de lo contrario, una cadena vacía. |
| lNative | Número de error de SQL Server. El número de error es idéntico al devuelto en el parámetro plNativeError del método ISQLErrorInfo::GetSQLInfo . |
| bState | Estado del error de SQL Server. |
| bClass | Gravedad del error de SQL Server. |
| wLineNumber | Cuando procede, la línea de un procedimiento almacenado de SQL Server que generó el mensaje de error. Si no hay ningún procedimiento implicado, el valor predeterminado es 1. |
Punteros de las direcciones de referencia de estructura de la cadena devueltas en el argumento ppErrorStrings .