aftp_extract_trace_level

The aftp_extract_trace_level call extracts the current trace level setting. If the aftp_set_trace_level call has not been invoked, the AFTP default trace level value is returned. The default value is AFTP_LVL_NO_TRACING.

AFTP_ENTRY aftp_extract_trace_level(
OUT AFTP_TRACE_LEVEL_TYPE AFTP_PTR trace_level,
OUT AFTP_RETURN_CODE_TYPE AFTP_PTR return_code
);

Parameters

trace_level

The current setting of the trace level in AFTP. The constants from AFTP_LVL_NO_TRACING to AFTP_LVL_MAX_TRACE_LVL incrementally increase the amount of trace information.

AFTP_LVL_NO_TRACING

Writes no data to the trace log.

AFTP_LVL_API

Traces crossings of the API boundary.

AFTP_LVL_MAX_TRACE_LVL

Provides the maximum amount of trace information.

return_code

The return code issued for this function. See AFTP Return Codes for the list of possible return codes.

Example

{
    AFTP_RETURN_CODE_TYPE         rc;
    AFTP_TRACE_LEVEL_TYPE         trace_level;

    /*
     * There are no prerequisite calls for this call.
     */

    aftp_extract_trace_level(&trace_level, &rc);

    if (rc != AFTP_RC_OK) {
        fprintf(stderr, "Error extracting trace level\n");
    }

}
 

Line Flows

None.