Name

omni_fdir − The omni_fdir obtains a list of file specifications from a remote directory. 

Syntax

extern unsigned long int omni_fdir [_a](
       unsigned long int        ∗invoke_id,
       omni_l_handle            vmd_handle,
       omni_t_file_name         remote_directory,
       unsigned long int        remote_directory_lengh,
       omni_l_context           ∗context,
       omni_l_handle   modifier_object,
       omni_r_iosb     ∗iosb,
       omni_r_ctrl     ∗ctrl);

Arguments

invoke_idaccess: write only mechanism: by reference optional argument An identifier assigned by DEComni.  The parameter is used for asynchronous calls only. 

vmd_handleaccess: read only mechanism: by value Longword identifier of a previously loaded VMD definition of a remote peer.  The VMD handle is returned by the omni_define procedure. 

remote_directoryaccess: read only mechanism: by reference A character string (in native format) representing the remote directory. 

remote_directory_length
access: read only mechanism: by value The length of the remote_directory in characters.

contextaccess: read/write mechanism: by reference A location for use by DEComni.  The context parameter is the address of the context location. 

modifier_objectaccess: read only mechanism: by value optional argument Reserved for future use. 

iosbaccess: write only mechanism: by reference optional argument The DEComni I/O status block.  The iosb parameter is the address of the status block. 

ctrlaccess: read only mechanism: by reference optional argument A control structure to specify an event flag. 

The ctrl parameter is the address of the control structure. 

Usage Notes

1omni_fdir obtains a directory.  To obtain the file specifications in the directory, call the omni_get_attribute procedure for each filespec. 

2omni_fdir allocates space for a buffer to contain the directory.  To release the buffer, call omni_end_list.