Códigos de retorno (proveedor OLE DB de Native Client)

Se aplica a: SQL Server Azure SQL Database Azure SQL Instancia administrada Azure Synapse Analytics Analytics Platform System (PDW)

En el nivel más básico, una función miembro se ejecuta correctamente o genera un error. En un nivel algo más preciso, puede que una función se ejecute correctamente pero que el resultado no sea el que esperaba el programador de la aplicación.

Para obtener más información sobre los códigos de retorno OLE DB, vea Códigos de retorno (OLE DB).

Cuando una función miembro del proveedor OLE DB de SQL Server Native Client devuelve S_OK, la función se realizó correctamente.

Cuando una función miembro del proveedor OLE DB de SQL Server Native Client no devuelve S_OK, las macros ERROR/COM HRESULT-unpacking FAILED y IS_ERROR pueden determinar el éxito o el error generales de una función.

Si FAILED o IS_ERROR devuelve TRUE, el consumidor del proveedor OLE DB de SQL Server Native Client está seguro de que se produjo un error en la ejecución de la función miembro. Cuando FAILED o IS_ERROR devuelven FALSE y HRESULT no es igual a S_OK, el consumidor del proveedor OLE DB de SQL Server Native Client está seguro de que la función se realizó correctamente en algún sentido. El consumidor puede recuperar información detallada sobre este retorno "correcto con información" de las interfaces de error del proveedor OLE DB de SQL Server Native Client. Además, en el caso de que una función produzca un error claramente (la macro FAILED devuelve TRUE), la información de error extendida está disponible en las interfaces de error del proveedor OLE DB de SQL Server Native Client.

Los consumidores del proveedor OLE DB de SQL Server Native Client suelen encontrar el DB_S_ERRORSOCCURRED devolución hrESULT de "éxito con información". Normalmente, las funciones miembro que devuelven DB_S_ERRORSOCCURRED definen uno o más parámetros que proporcionen valores de estado al consumidor. Es posible que no haya más información de error disponible para el consumidor que los parámetros de valor de estado devueltos, de modo que los consumidores deban implementar la lógica de la aplicación para recuperar los valores de estado cuando estén disponibles.

Las funciones miembro del proveedor OLE DB de SQL Server Native Client no devuelven el código correcto S_FALSE. Todas las funciones miembro del proveedor OLE DB de SQL Server Native Client siempre devuelven S_OK para indicar que se ha realizado correctamente.

Consulte también

Errores