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 obter informações gerais sobre SQLNativeSql, consulte Função SQLNativeSql.

Se o driver der suporte a essa função, a biblioteca de cursores chamará SQLNativeSql no driver e a transmitirá a instrução SQL. Para as instruções update, positioned delete e SELECT FOR UPDATE posicionadas, a biblioteca de cursores modifica a instrução antes de passá-la para o driver.

Observação

A biblioteca de cursores retornará incorretamente SQLSTATE 34000 (nome do 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 de SQLNativeSql. SQLNativeSql não se destina a retornar erros de sintaxe, que são retornados somente após a preparação ou execução da instrução.