SQLEndTran (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 SQLEndTran na biblioteca de cursores. Para obter informações gerais sobre SQLEndTran, consulte Função SQLEndTran.

A biblioteca de cursores não dá suporte a transações e passa chamadas para SQLEndTran diretamente para o driver. No entanto, a biblioteca de cursores dá suporte aos comportamentos de confirmação e reversão do cursor, conforme retornado pela fonte de dados com os tipos de informações SQL_CURSOR_ROLLBACK_BEHAVIOR e SQL_CURSOR_COMMIT_BEHAVIOR:

• Para fontes de dados que preservam cursores entre transações, as alterações revertidas na fonte de dados não são revertidas no cache da biblioteca de cursores. Para fazer com que o cache corresponda aos dados na fonte de dados, o aplicativo deve fechar e reabrir o cursor.

• Para fontes de dados que fecham cursores em limites de transação, a biblioteca de cursores fecha os cursores e exclui os caches de todas as instruções na conexão.

• Para fontes de dados que excluem instruções preparadas nos limites da transação, o aplicativo deve repreparar todas as instruções preparadas na conexão antes de reexecutá-las.