Purpose

Executes the UDS ControlDTCSetting service. Modifies Diagnostic Trouble Code (DTC) behavior.

Format

        long ndUDSControlDTCSetting(
       TD1 *diagRef,
       unsigned char type,
       unsigned char dataIn[],
       long len,
       LVBoolean *success);
      

Input

diagRef

Specifies the diagnostic session handle, obtained from ndOpenDiagnosticOnCANFD or ndOpenDiagnosticOnIPStack and passed to subsequent diagnostic functions. Normally, it is not necessary to manually manipulate the elements of this struct.

type

Specifies the control mode:

1: on

2: off

dataIn

Specifies application-specific data that control DTC generation.

len

Must contain the number of valid data bytes in dataIn. Output

success

Indicates successful receipt of a positive response message for this diagnostic service.

Return Value

The return value indicates the function call status as a signed 32-bit integer. Zero means the function executed successfully. A negative value specifies an error, which means the function did not perform the expected behavior. A positive value specifies a warning, which means the function performed as expected, but a condition arose that may require attention.

Use the ndStatusToString function to obtain a descriptive string for the return value.