Usar uma instrução (ODBC)

Para usar uma instrução

  1. Chame SQLAllocHandle com um HandleType de SQL_HANDLE_STMT para alocar um identificador de instrução.

  2. Opcionalmente, chame SQLSetStmtAttr para definir opções de instrução ou SQLGetStmtAttr para obter atributos de instrução.

    Para usar cursores de servidor, você deve definir atributos de cursor para valores diferentes dos padrões.

  3. Opcionalmente, se a instrução for executada várias vezes, prepare a instrução para execução com a Função SQLPrepare.

  4. Opcionalmente, se a instrução tiver marcadores de parâmetro associados, associe os marcadores de parâmetro a variáveis de programa usando SQLBindParameter. Se a instrução estiver preparada, você poderá chamar SQLNumParams e SQLDescribeParam para localizar o número e as características dos parâmetros.

  5. Execute uma instrução diretamente usando SQLExecDirect.

    - ou -

    Se a instrução foi preparada, execute-a várias vezes usando SQLExecute.

    - ou -

    Chame uma função de catálogo, que retorna resultados.

  6. Processe os resultados associando as colunas do conjunto de resultados a variáveis de programa, movendo dados das colunas do conjunto de resultados para variáveis de programa usando SQLGetData ou uma combinação dos dois métodos.

    Busque pelo conjunto de resultados de uma instrução uma linha de cada vez.

    - ou -

    Busque pelo conjunto de resultados várias linhas de cada vez usando um cursor de bloco.

    - ou -

    Chame SQLRowCount para determinar o número de linhas afetadas por uma instrução INSERT, UPDATE ou DELETE.

    Se a instrução SQL puder ter vários conjuntos de resultados, chame SQLMoreResults no final de cada conjunto de resultados para ver se há conjuntos de resultados adicionais a serem processados.

  7. Depois que os resultados são processados, as seguintes ações podem ser necessárias para disponibilizar o identificador de instrução para executar uma nova instrução:

    • Se você não chamou SQLMoreResults até que ele retornasse SQL_NO_DATA, chame SQLCloseCursor para fechar o cursor.

    • Se você associar marcadores de parâmetro a variáveis de programa, chame SQLFreeStmt com Option definido como SQL_RESET_PARAMS para liberar os parâmetros associados.

    • Se você associar colunas de conjunto de resultados a variáveis de programa, chame SQLFreeStmt com Option definido como SQL_UNBIND para liberar as colunas associadas.

    • Para reutilizar o identificador de instrução, vá para a Etapa 2.

  8. Chame SQLFreeHandle com um HandleType de SQL_HANDLE_STMT para liberar o identificador de instrução.

Consulte Também

Executando tópicos de instruções de consultas (ODBC)

  • Last updated on