FTAM/9000 Programmer's Guide

290 Chapter 7
Managing and Accessing HP FTAM/9000 Files
Opening and Closing Files (HLCS)
Ft_fopen_out_dcb
struct Ft_fopen_out_dcb {
Uint32 size;
struct Api_rc result;
enum Ft_state_result state_result;
enum Ft_action_result action_result;
struct Ft_attributes attributes;
struct Ft_concurrency_control *concurrency_control;
struct Ft_diagnostic *diagnostic;
};
ft_fopen() Parameters
ft_fopen()
Parameter
Type Description
connection_id Mandatory
Input
Uniquely identifies a specific connection to the
filestore
filename Mandatory
Input
Path name of the file you are opening; must be
in the syntax of the real filestore
file_status Mandatory
Input
Determines the action to take if the file already
exists
requested_access Mandatory
Input
Specifies the actions you want to perform on the
file
contents_type Mandatory
Input
Specifies the document type of the file you are
creating or opening
return_event_name Mandatory
Input
If the call is asynchronous, uniquely identifies
the function call; if the call is synchronous, the
value is 0 (zero)
input_dcb-
>attributes
Optional Uniquely identifies the file you are creating and
opening; do not use input_dcb-
>attributes.values.filename or input_dcb-
>attributes.values.contents_type
input_dcb->
concurrency_control
Optional File access locks required on the actions
specified in requested_access
input_dcb->
file_passwords
Optional Passwords associated with the actions specified
by requested_access