SQLNativeSql (Biblioteca de Cursores)

Importante

Esse recurso será removido em uma versão futura do Windows. Evite usar esse recurso em um novo trabalho de desenvolvimento e planeje modificar aplicativos que atualmente usam esse recurso. A Microsoft recomenda usar a funcionalidade de cursor do driver.

Este tópico discute o uso da função SQLNativeSQL na biblioteca de cursores. Para informações gerais sobre SQLNativeSql, veja Função SQLNativeSQL.

Se o driver suportar essa função, a biblioteca de cursores chama SQLNativeSql no driver e passa a instrução SQL. Para atualizações posicionadas, exclusão posicionada e SELECT FOR UPDATE , a biblioteca de cursores modifica a instrução antes de passá-la para o driver.

Note

A biblioteca de cursores retorna incorretamente SQLSTATE 34000 (nome de cursor inválido) se o nome do cursor for inválido em uma instrução de atualização ou exclusão posicionada que é passada no argumento InStatementText do SQLNativeSql. SQLNativeSql não tem a intenção de devolver erros de sintaxe, que são retornados apenas após a preparação ou execução da instrução.