Коды возврата (поставщик OLE DB собственного клиента)

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

Для краткости можно сказать, что вызов функции-члена класса или структуры завершается успешно либо с ошибкой. Точнее сказать, вызов функции может оказаться успешным, но результат оказывается не таким, на какой рассчитывал разработчик приложения.

Дополнительные сведения о кодах возврата OLE DB см. в статье Коды возврата (OLE DB).

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

Если функция-член поставщика OLE DB собственного клиента SQL Server не возвращает S_OK, то макросы OLE/COM HRESULT с распаковкой сбоем и IS_ERROR макросы могут определить общий успех или сбой функции.

Если не удалось или IS_ERROR возвращает значение TRUE, потребитель поставщика OLE DB собственного клиента SQL Server гарантирует, что выполнение функции-члена завершилось сбоем. Если ошибка или IS_ERROR возвращает значение FALSE, а HRESULT не равно S_OK, потребитель поставщика OLE DB sql Server Native Client гарантирует, что функция успешно выполнена в некотором смысле. Потребитель может получить подробные сведения об этом "успешном выполнении с информацией", возвращаемой из интерфейсов ошибок поставщика OLE DB собственного клиента SQL Server. Кроме того, в случае, когда функция явно завершается ошибкой (макрос FAILED возвращает TRUE), расширенные сведения об ошибках доступны из интерфейсов ошибок поставщика OLE DB собственного клиента SQL Server.

Потребители поставщика OLE DB собственного клиента SQL Server обычно сталкиваются с DB_S_ERRORSOCCURRED "успешное выполнение с информацией" возврат HRESULT. Функции-члены, возвращающие значение DB_S_ERRORSOCCURRED, обычно определяют один или несколько параметров, предоставляющих потребителю значения состояния. Информация, возвращаемая через параметры состояния, может быть единственной информацией о состоянии, доступной потребителю; поэтому для получения значений состояния, когда они доступны, потребители должны реализовать собственную логику приложения.

Функции-члены поставщика OLE DB для собственного клиента SQL Server не возвращают код успеха S_FALSE. Все функции-члены поставщика OLE DB собственного клиента SQL Server всегда возвращают S_OK, чтобы указать успешность.

См. также

ошибки