Códigos de retorno
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 la página sobre códigos de retorno (OLE DB) (en inglés).
Si una función miembro de proveedor OLE DB de SQL Server Native Client devuelve S_OK, significa que se ha ejecutado correctamente.
Si una función miembro de proveedor OLE DB de SQL Server Native Client 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 de proveedor OLE DB de SQL Server Native Client sabe que se produjo 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 proveedor OLE DB de SQL Server Native Client 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 proveedor OLE DB de SQL Server Native Client. Asimismo, en el caso en el que se produzca claramente un error en una función (la macro FAILED devuelve TRUE), se puede consultar amplia información sobre el error 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 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 del proveedor OLE DB de SQL Server Native Client no devuelven el código de ejecución correcta S_FALSE. Todas las funciones miembro del proveedor OLE DB de SQL Server Native Client devuelven siempre S_OK para indicar que la ejecución ha sido correcta.