ISQLServerErrorInfo::GetErrorInfo (OLE DB)
返回一个指针，该指针指向包含相应 SQL Server 错误详细信息的 SQL Server Native Client OLE DB 访问接口 SSERRORINFO 结构。
语法
HRESULT GetErrorInfo(
SSERRORINFO**ppSSErrorInfo,
OLECHAR**ppErrorStrings);
参数
ppSSErrorInfo[out]
指向 SSERRORINFO 结构的指针。 如果方法失败或者不存在与该错误关联的任何 SQL Server 信息，则访问接口不会分配任何内存，并且会确保 ppSSErrorInfo 参数在输出时为一个 Null 指针。ppErrorStrings[out]
指向 Unicode 字符串指针的指针。 如果方法失败或者不存在与错误关联的任何 SQL Server 信息，则访问接口不会分配任何内存，并且会确保 ppErrorStrings 参数在输出时为一个 Null 指针。 如果使用 IMalloc::Free 方法释放 ppErrorStrings 参数，则会释放所返回 SSERRORINFO 结构的三个单个字符串成员，因为内存是按块进行分配的。
返回代码值
S_OK
方法成功。E_INVALIDARG
ppSSErrorInfo 或 ppErrorStrings 参数为 NULL。E_OUTOFMEMORY
SQL Server Native Client OLE DB 访问接口无法分配足够的内存来完成请求。
注释
SQL Server Native Client OLE DB 访问接口为通过使用者传递的指针返回的 SSERRORINFO 和 OLECHAR 字符串分配内存。 当使用者不再需要访问错误数据时，使用者必须使用 IMalloc::Free 方法释放该内存。
SSERRORINFO 结构的定义如下所示：
typedef struct tagSSErrorInfo
{
LPOLESTR pwszMessage;
LPOLESTR pwszServer;
LPOLESTR pwszProcedure;
LONG lNative;
BYTE bState;
BYTE bClass;
WORD wLineNumber;
}
SSERRORINFO;
成员 |
说明 |
|---|---|
pwszMessage |
来自 SQL Server 的错误消息。 消息是通过 IErrorInfo::GetDescription 方法返回的。 |
pwszServer |
在其上发生了该错误的 SQL Server 实例的名称。 |
pwszProcedure |
如果错误发生在存储过程中，则为生成该错误的存储过程的名称；否则，为空字符串。 |
lNative |
SQL Server 错误号。 该错误号与在 ISQLErrorInfo::GetSQLInfo 方法的 plNativeError 参数中返回的错误号相同。 |
bState |
SQL Server 错误的状态。 |
bClass |
SQL Server 错误的严重性。 |
wLineNumber |
如果适用，为生成错误消息的 SQL Server 存储过程的行。 如果与过程无关，则为默认值 1。 |
结构中的指针引用在 ppErrorStrings 参数中返回的字符串中的地址。