DISC

Contents | What's New | Quick Links

 

OmniAccess API

Introduction

Software Installation

Concepts and Design

Designing Applications

Omnidex Environments

SQL Reference

Omnidex API's

Utilities

Interfaces

Performance Guide

Troubleshooting Guide

Appendix

 

 

OAFETCH

 

oafetch retrieves rows and places them in buffer. The source of the rows and the columns to be returned is established by oaselect.

oaqualify and oaselect designate rows for retrieval. The next call to oafetch for the cursor initiates the retrieval of rows previously qualified or selected. As a result, the area defined by buffer must match the layout implied by the list of columns defined in the last successful call to oaselect for the cursor.

Related Links

Related Links

 

Syntax

oafetch (cursor, options, status, num_rows, buffer)

cursor -- Is a 32-bit signed integer passed by value. This is the value returned by a successful call to oaopencursor.

options -- Is currently reserved and must contain a semicolon or a null character passed by reference.

status -- Returns information about the success or failure of the oafetch routine. The status structure is passed by reference and contains fourteen 32-bit signed integers, followed by a 36-character buffer.

An End of data condition is returned as an error if you try to fetch when no rows were selected. An End of data condition is returned as a warning if the number of rows selected is greater than zero but less than count.

count -- Contains the number of row complexes (record complexes) to retrieve with oafetch. Count is a 32-bit signed integer passed by value.

buffer -- Is a pointer to a buffer area that receives the rows specified by the columns parameter of oaselect. Binary data may require conversion when rows are transferred from the server to a client. For more information about byte-ordering, see byte ordering and byte boundaries.

Buffer is ignored if oaselect was called with the COLUMN option. You must then use oadescribe and oabind to establish the buffers for each select item.

top

 

Options

There are currently no options available for oafetch.

 

top

 

Example

 

 

top

Dynamic Information Systems Corporation - Omnidex Version 3.8 Build 6 J15.03-Copyright © 2003

DISC | Documentation Home