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


Сведения в интерфейсах ошибок, определенных OLE DB

Применимо: SQL Server База данных SQL Azure Управляемый экземпляр SQL Azure azure Synapse Analytics Analytics Platform System (PDW)

Поставщик OLE DB собственного клиента SQL Server сообщает некоторые сведения об ошибке и состоянии в определяемых OLE DB интерфейсах ошибок IErrorInfo, IErrorRecords и ISQLErrorInfo.

Поставщик OLE DB собственного клиента SQL Server поддерживает функции-члены IErrorInfo следующим образом.

Функция-член Description
GetDescription Строка описательного сообщения об ошибке.
GetGUID Идентификатор GUID интерфейса, в котором была определена ошибка.
GetHelpContext Не поддерживается. Всегда возвращает значение 0.
GetHelpFile Не поддерживается. Всегда возвращает значение NULL.
GetSource Строка «Собственный клиент Microsoft SQL Server».

Поставщик OLE DB собственного клиента SQL Server поддерживает функции-члены IErrorRecords, доступные для потребителей, как показано ниже.

Функция-член Description
GetBasicErrorInfo Заполняет структуру ERRORINFO основными сведениями об ошибке. Структура ERRORINFO содержит элементы, которые идентифицируют возвращаемое значение HRESULT для ошибки, поставщика и интерфейс, к которому относится ошибка.
GetCustomErrorObject Возвращает ссылку на интерфейсы ISQLErrorInfo и ISQLServerErrorInfo.
GetErrorInfo Возвращает ссылку на интерфейс IErrorInfo.
GetErrorParameters Поставщик OLE DB собственного клиента SQL Server не возвращает параметры потребителю через GetErrorParameters.
GetRecordCount Число доступных записей ошибок.

Поставщик OLE DB собственного клиента SQL Server поддерживает параметры ISQLErrorInfo::GetSQLInfo следующим образом.

Параметр Описание
pbstrSQLState Возвращает значение SQLSTATE для ошибки. Значения SQLSTATE определены в стандартах SQL-92, ODBC и ISO SQL, а также спецификациях API-интерфейсов. Ни SQL Server, ни поставщик OLE DB собственного клиента SQL Server не определили значения SQLSTATE для конкретной реализации.
plNativeError Возвращает номер ошибки SQL Server из master.dbo.sysmessagesages при наличии. Собственные ошибки доступны после успешной попытки инициализации источника данных поставщика OLE DB собственного клиента SQL Server. Перед попыткой поставщик OLE DB собственного клиента SQL Server всегда возвращает ноль.

См. также

ошибки