FTAM/9000 Programmer's Guide

314 Chapter 8
Transferring HP FTAM/9000 Data
Reading Data
• If you specify FT_UNSTRUCTURED_ALL_DATA_UNITS in
access_context for FTAM-2 files, you receive only the data elements,
not the node descriptors (structuring information). If you specify
FT_FLAT_ALL_DATA_UNITS in access_context for FTAM-2 files,
you receive both data elements and node descriptors.
Ft_read_out_dcb
struct Ft_read_out_dcb {
Uint32 size;
struct Api_rc result;
};
ft_read() Parameters
ft_read()
Parameter
Type Description
connection_id Mandatory
Input
Uniquely identifies a specific connection to the
filestore
fadu_identity Mandatory
Input
Identifies the FADU to read
access_context Mandatory
Input
Specifies the access context; depends on the
document type
return_event_name Mandatory
Input
If the call is asynchronous, uniquely identifies
the function call; if the call is synchronous, the
value is zero
input_dcb Optional Input Contains no information; pass a NULL pointer
inout_dcb->size Mandatory
input if using
inout_dcb
Size (in Octets) of the inout_dcb structure and
data
inout_dcb->result Output Pointer to the struct Api_rc containing the
outcome of the operation: result_code and
vendor_code (HP-UX—specific error)