Name

omni_fdelete − The omni_fdelete procedure deletes a file from a remote system. 

Syntax

extern unsigned long int omni_fdelete [_a](
       unsigned long int       ∗invoke_id,
       omni_l_handle           vmd_handle,
       omni_t_file_name        remote_file_name,
       unsigned long int       remote_file_name_length,
       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_file_nameaccess: read only mechanism: by value The file specification for the remote file to delete. 

remote_file_name_length
access: read only mechanism: by value The length of the remote_file_name parameter in characters.

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

1Wild cards will be delivered to the remote device as specified. 

2See PIC for remote device specification.