Usar una instrucción (ODBC)

Para usar una instrucción

1. Llame a SQLAllocHandle con un HandleType de SQL_HANDLE_STMT para asignar un identificador de instrucción.

2. Opcionalmente, llame a SQLSetStmtAttr para establecer opciones de instrucción o SQLGetStmtAttr para obtener atributos de instrucción.

   Para usar cursores de servidor, debe establecer atributos de cursor en valores distintos de sus valores predeterminados.

3. Opcionalmente, si la instrucción se ejecutará varias veces, prepare la instrucción para su ejecución con la función SQLPrepare.

4. Opcionalmente, si la instrucción tiene marcadores de parámetro enlazados, enlace los marcadores de parámetro a variables de programa mediante SQLBindParameter. Si la instrucción se preparó, puede llamar a SQLNumParams y SQLDescribeParam para buscar el número y las características de los parámetros.

5. Ejecute una instrucción directamente mediante SQLExecDirect.

   - o -

   Si la instrucción se preparó, ejecútelo varias veces mediante SQLExecute.

   - o -

   Llame a una función de catálogo, que devuelve resultados.

6. Procese los resultados enlazando las columnas del conjunto de resultados a variables de programa moviendo datos de las columnas del conjunto de resultados a variables de programa mediante SQLGetData o una combinación de los dos métodos.

   Capturar a través del conjunto de resultados de una instrucción una fila a la vez.

   - o -

   Capturar a través del conjunto de resultados varias filas a la vez mediante un cursor de bloque.

   - o -

   Llame a SQLRowCount para determinar el número de filas afectadas por una instrucción INSERT, UPDATE o DELETE.

   Si la instrucción SQL puede tener varios conjuntos de resultados, llame a SQLMoreResults al final de cada conjunto de resultados para ver si hay conjuntos de resultados adicionales para procesar.

7. Una vez procesados los resultados, es posible que sea necesario realizar las siguientes acciones para que el identificador de instrucción esté disponible para ejecutar una nueva instrucción:

   • Si no llamó a SQLMoreResults hasta que devolvió SQL_NO_DATA, llame a SQLCloseCursor para cerrar el cursor.

   • Si enlaza marcadores de parámetro a variables de programa, llame a SQLFreeStmt con Option establecido en SQL_RESET_PARAMS para liberar los parámetros enlazados.

   • Si enlaza columnas del conjunto de resultados a variables de programa, llame a SQLFreeStmt con Option establecido en SQL_UNBIND para liberar las columnas enlazadas.

   • Para reutilizar el identificador de instrucción, vaya al paso 2.

8. Llame a SQLFreeHandle con un HandleType de SQL_HANDLE_STMT para liberar el identificador de instrucción.

Véase también

Ejecución de temas de procedimientos de consultas (ODBC)