SQL_exec_prepared

c/c++pascal

BOOL [cd_]SQL_exec_prepared([cdp_t cdp], uns32 handle, uns32 * results, int * count);
function [cd_]SQL_exec_prepared([cdp : cdp_t]; handle : uns32; var results : uns32; var count : integer) : Boolean;

Parametry

handle handle (číslo) SQL požadavku získané funkcí SQL_prepare
results pole čísel, do nichž se zapíše informace o výsledku operace; pole musí mít svou první složku před zavoláním inicializovanou hodnotou nula
count počet SQL příkazů - výstupní parametr
[cdp kontextová proměnná klienta]

Od verze:

5.1

Popis

Funkce provede dříve připravený příkaz, jehož handle dostane jako parametr.

Při volání funkce z vnějšího jazyka je nutné uvést výstupní parametr results. Tímto parametrem je pole 32-bitových celých čísel bez znaménka. Pole musí obsahovat nejméně tolik složek, kolik příkazů jazyka SQL je zadáno v parametru statement funkce SQL_prepare. Parametr results slouží k získání informací o výsledku provádění příkazu. Má relevantní hodnotu pouze v případě, že funkce skončila úspěšně. Pokud byl proveden příkaz UPDATE, DELETE nebo INSERT, hodnotou příslušného prvku pole je počet zpracovaných záznamů. Pokud byl proveden dotazový výraz SELECT (není SQL příkaz, lze ho však zde použít pro otevření dotazu), pak ve spodních dvou bajtech prvku pole je číslo otevřeného kurzoru a s otevřeným kurzorem je možné dále pracovat (stejně jako by byl otevřen pomocí funkce Open_cursor_direct). Otevřený kurzor se zavírá pomocí funkce Close_cursor.

Počet provedených SQL příkazů je zapsán do výstupní proměnné count.

Hodnota funkce

Funkce vrací TRUE při chybě.

Viz