Partilhar via


Excluir linhas no conjunto de linhas com SQLSetPos

A operação de exclusão do SQLSetPos faz com que a fonte de dados exclua uma ou mais linhas selecionadas de uma tabela. Para excluir linhas com SQLSetPos, o aplicativo chama SQLSetPos com a Operation definido como SQL_DELETE e RowNumber definido como o número da linha a ser excluída. Se RowNumber for 0, todas as linhas do conjunto de linhas serão excluídas.

Depois que o SQLSetPos retorna, a linha excluída é a linha atual e seu status é SQL_ROW_DELETED. A linha não pode ser usada em outras operações posicionadas, como chamadas para SQLGetData ou SQLSetPos.

Ao excluir todas as linhas do conjunto de linhas (RowNumber é igual a 0), o aplicativo pode impedir que o driver exclua determinadas linhas usando a matriz de operação de linha, da mesma forma que para a operação de atualização do SQLSetPos. (Veja Atualizar linhas no conjunto de linhas com SQLSetPos.)

Todas as linhas excluídas devem existir no conjunto de resultados. Se os buffers do aplicativo tiverem sido preenchidos pela busca e se uma matriz de status de linha tiver sido mantida, seus valores em cada uma das novas posições de linha não deverão ser SQL_ROW_DELETED, SQL_ROW_ERROR ou SQL_ROW_NOROW.