Códigos de retorno

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

Descargar controlador OLE DB

En un nivel básico, una función miembro se ejecuta correctamente o genera un error. Pero cuando una función se ejecuta correctamente, es posible que su éxito no sea el previsto para el desarrollador 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 de OLE DB Driver for SQL Server devuelve S_OK, la función se ejecuta correctamente.

Si una función miembro del controlador OLE DB para SQL Server no devuelve S_OK, las macros que desempaquetan la OLE/COM HRESULT, FAILED e IS_ERROR, pueden determinar si en general una función se ha ejecutado correctamente o no.

Si FAILED o IS_ERROR devuelven TRUE, el consumidor del controlador OLE DB para SQL Server sabe que se ha producido un error en la ejecución de la función miembro. Si FAILED o IS_ERROR devuelven FALSE y HRESULT no es igual a S_OK, el consumidor de OLE DB Driver for SQL Server tiene la seguridad de que la función se ejecutó correctamente en algún sentido. El consumidor puede recuperar información detallada sobre este retorno de "ejecución correcta con información" de las interfaces de error del controlador OLE DB para SQL Server. Además, en el caso en el que se produzca claramente un error en una función (la macro FAILED devuelve TRUE), se puede consultar más información sobre el error en las interfaces de error del controlador OLE DB para SQL Server.

Los consumidores de OLE DB Driver for SQL Server suelen encontrar el retorno HRESULT de "ejecución correcta con información" DB_S_ERRORSOCCURRED. 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 de OLE DB Driver for SQL Server no devuelven el elemento S_FALSE de código de acierto. Todas las funciones miembro de OLE DB Driver for SQL Server siempre devuelven S_OK para indicar que la operación se ha realizado correctamente.

Consulte también

Errores