SQL_BLOB_VAL_CLOSE - SQLbvcl

SQL_BLOB_VAL_CLOSE beendet die Verwendung eines Access-Handles, das mit SQL_BLOB_VAL_OPEN (siehe "SQL_BLOB_VAL_OPEN - SQLbvop") eröffnet wird.

Mit einem Access-Handle ist es möglich, BLOB-Werte sequenziell zu bearbeiten. Dabei werden die Aufrufe SQL_BLOB_VAL_FETCH (siehe "SQL_BLOB_VAL_FETCH - SQLbvfe") zum sequenziellen Lesen und SQL_BLOB_VAL_STOW (siehe "SQL_BLOB_VAL_STOW - SQLbvst") zum sequenziellen Schreiben angeboten.

Falls Sie versuchen ein Access-Handle zu beenden, das bereits beendet wurde, erhalten Sie eine Fehlermeldung.
SQL_BLOB_VAL_CLOSE kann das INSERT-Privileg auf die BLOB-Tabelle erfordern.

CLI-Deklaration in C:

void SQL_BLOB_VAL_CLOSE( char *AccessHandle
                        ,struct SQLda_t *SQLda);

CLI-Deklaration in COBOL:

IDENTIFICATION DIVISION.
PROGRAM-ID. SQLbvcl IS PROTOTYPE.
DATA DIVISION.
   01 AccessHandle PIC X(32).
   COPY SQLCA.     *> for group item SQLda.
LINKAGE SECTION.
PROCEDURE DIVISION USING AccessHandle, SQLda.
END PROGRAM SQLbvcl.

AccessHandle

Der bei SQL_BLOB_VAL_OPEN gelieferte Wert für das zu beendende Access-Handle muss hier eingegeben werden. Dieser Wert darf vom Aufrufer nicht modifiziert werden.

SQLda

Diagnosebereich.