FAPI_GETL

Use the FAPI_GETL_FIND function to issue the GETL FIND request to find one line of output returned from the FTP client by an FAPI_INIT, FAPI_SCMD, or FAPI_POLL. See Sending requests to the FTP client API for more information on a GETL request.

FAPI_GETL_FIND accepts the following parameters:

FCAI_MAP

A pointer to an fcai_map_t structure used to save information about the request using the FTP client API.

type

A character that indicates what type of output is requested by the copy. Possible type values include:

Field constant defined in ftpcapi.h	Value	Meaning
FAPI_GETL_MESSAGE_LINE	M	Message from the client.
FAPI_GETL_REPLY_LINE	R	Reply from the server.
FAPI_GETL_TRACE_LINE	T	Trace output from debug or dump.
FAPI_GETL_LIST_LINE	L	List data from a DIR or LS subcommand.
FAPI_GETL_ANY_LINE	A	Any type of output line.

buffer_len

The length of the buffer used for the copy.

buffer

The address of the buffer used in the operation.

sequence

A character that indicates which of the output lines of type should be found. Valid sequence values include:

Field constant defined in ftpcapi.h	Value	Meaning
FAPI_GETL_FIND_FIRST	F	Find the first line of the requested type.
FAPI_GETL_FIND_NEXT	N	Find the next line of the requested type.
FAPI_GETL_FIND_LAST	L	Find the last line of the requested type.