aftp_local_dir_open
The aftp_local_dir_open call begins a directory listing and specifies the file search parameters on the AFTP client. The aftp_local_dir_read call is used to read individual directory entries. The aftp_local_dir_close call is used to end the directory listing. A connection to the AFTP server is not required before using this call.
See AFTP File and Directory Concept for details on how the directory concept is handled for supported operating systems.
AFTP_ENTRY aftp_local_dir_open(
IN AFTP_HANDLE_TYPE connection_id,
IN unsigned char AFTP_PTR filespec,
IN AFTP_LENGTH_TYPE length,
IN AFTP_FILE_TYPE_TYPE file_type,
IN AFTP_INFO_LEVEL_TYPE info_level,
OUT unsigned char AFTP_PTR path,
IN AFTP_LENGTH_TYPE path_buffer_length,
OUT AFTP_LENGTH_TYPE AFTP_PTR path_returned_length,
OUT AFTP_RETURN_CODE_TYPE AFTP_PTR return_code
);
Parameters
-
connection_id
-
An AFTP connection object originally created with aftp_create.
-
filespec
-
The search string that the client uses to generate the directory listing. The files in the listing must match the search string. The format of this name can be either the native syntax on the AFTP client or the AFTP common naming convention described in the APPC Application Suite User's Guide. The file specified can be either an absolute or relative path name and can contain wildcard characters.
-
length
-
The length of the filespec parameter in bytes.
-
file_type
-
The type of information (directory names or file names) to be returned.
-
AFTP_FILE
-
Only file entries.
-
AFTP_DIRECTORY
-
Only directory entries.
-
AFTP_ALL_FILES
-
Both file and directory entries.
-
info_level
-
The level and format of information to be returned about each file or directory entry.
-
AFTP_NATIVE_NAMES
-
Native names without attributes.
-
AFTP_NATIVE_ATTRIBUTES
-
Native names and native file attributes.
-
path
-
The fully qualified directory name in which of all of the directory entries exist. The actual directory entries will be returned when the aftp_local_dir_read call is used. The path can be used along with the returned directory entry file name to create a fully qualified path name to use on another AFTP file call.
Use the AFTP_FILE_NAME_SIZE constant to define the length of this buffer. Add 1 to the size if you want to be able to add a null terminator to the text in the buffer.
-
path_buffer_length
-
The size in bytes of the buffer pointed to by the path parameter.
-
path_returned_length
-
The number of bytes returned in the path parameter.
-
return_code
-
The return code issued for this function. See AFTP Return Codes for the list of possible return codes.
Example
See aftp_local_dir_read for a complete example showing the related calls aftp_local_dir_open, aftp_local_dir_read, and aftp_local_dir_close.
Line Flows
None.