DbiOpenNestedTable

<< Click to Display Table of Contents >>

Navigation:  »No topics above this level«

DbiOpenNestedTable

Return to chapter overview

C syntax

DBIResult DBIFN DbiOpenNestedTable(hDBICur hCursor, UINT16 iFieldNo, BOOL bReadOnly, BOOL bUniDirectional, phDBICur hCursorNested);

Delphi syntax

function DbiOpenNestedTable(hCursor: hDBICur; iFieldNo: Word; bReadOnly: Bool; bUniDirectional: Bool; var hCursorNested: hDBICur): DBIResult; stdcall;

Description

DbiOpenNestedTable creates a new cursor for the nested table field.

Parameters

hCursor                Type: hDBICur                (Input)
Specifies the cursor handle of the table.

iFieldNo                Type: UNINT16                (Input)
Specifies the ordinal number of the nested table field within the record buffer.

bReadOnly                BOOL                (Input)
If True, the nested table is opened in dbiREADONLY mode and cannot be modified.

bUniDirectional                BOOL                (Input)
TRUE if this cursor is unidirectional (SQL only).

hCursorNested                hDBICur                (Output)
pointer to the cursor handle for the nested table.

Prerequisites

Parent cursor must be opened by a DbiOpenTable or by executing a query.

DbiResult

Meaning

DBIERR_NONE

The nested table was opened successfully.

DBIERR_NA

The iFieldNo specified is not a nested table column.

See also

DbiOpenRef, DbiCloseCursor