Use the a_v4_extfn_row structure to represent the data in a single row.
/* a_v4_extfn_row - */
typedef struct a_v4_extfn_row {
a_sql_uint32 *row_status;
a_v4_extfn_column_data *column_data;
} a_v4_extfn_row;
| Data Member | Data Type | Description |
|---|---|---|
| row_status | a_sql_uint32 * | The status of the row. Set to 1 for existing rows and 0 otherwise. |
| column_data | a_v4_extfn_column_data * | An array of column data for the row. |
The row structure contains information for a specific row of columns. This structure defines the status of an individual row and includes a pointer to the individual columns within the row. The row status is a flag that indicates the existence of a row. The row status flag can be altered by nested fetch calls without requiring manipulation of the row block structure.
The row_status flag set as 1 indicates that the row is available and can be included in the result set. The row_status set as 0 means the row should be ignored. This is useful when the TPF is acting as a filter because TPF may pass through rows of an input table to the result set, but it may also want to skip certain rows, which it can do by setting a status of 0 for those rows.