|Download Help (Windows Only)|
Retrieves a comma-separated list of ECU names, Measurement names, Characteristic names, Event names, Characteristic pages, or Group names from a specified A2L database.
RefNum is any ECU M&C task reference which consists of a valid link to the opened A2L database (DBRefNum), a selected ECU (ECURefNum) or a Measurement task (DAQRefNum). RefNum has to be valid for the related Type.
Specifies the Type of names to return.
Returns a list of ECU names. You can pass one of the returned names to mcECUSelectEx.
Returns a list of Measurement names. You can pass the returned NamesList to mcDAQInitialize.
Returns a list of Event Channel names.
Returns a list of Calibration page names.
Returns a list of Group names.
Returns a list of Subgroup names of the specified Group name.
Returns a list of Measurement names within the specified Group.
Returns a list of Characteristic names within the specified Group.
Returns a list of Function names within the specified ECU.
Returns a list of Characteristic names referred by the DEF_CHARACTERISTIC keyword within the related Function.
Returns a list of Characteristic names referred by the REF_CHARACTERISTIC keyword within the related Function.
Returns a list of Measurement names referred by the IN_MEASUREMENT keyword within the related Function.
Returns a list of Measurement names referred by the OUT_MEASUREMENT keyword within the related Function.
Returns a list of Measurement names referred by the LOC_MEASUREMENT keyword within the related Function.
Returns a list of Function names referred by the SUB_FUNCTION keyword within the related Function.
Returns a list of Function names referred by the FUNCTION_LIST keyword within the related Group.
If the Type = mcTypeMeasurementNames or Type = mcTypeCharacteristicNames and RefNum contains a DBRefNum, the corresponding ECU name has to be referenced in order to access ECU specific properties. If RefNum contains an ECURefNum or DAQRefNum the parameter ECUName is ignored and can be set to NULL.
Size of the buffer provided to take the names list. After calling mcGetNamesLength, you can allocate an array of size SizeofNamesList, and then pass that array to mcGetNames using the same input parameters. This ensures that mcGetNames will return all names without error.
Returns the comma-separated list of names specified by Type.
The return value indicates the status of the function call 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 mcStatusToString function of the ECU M&C API to obtain a descriptive string for the return value.
Get a comma-separated list of ECU, Measurement, Characteristic, or Event Channel names from a specified A2L database file.
If using mcGetNames to query the list of supported event channels on an ECU, the event channels might be stored inside the ECU instead of the A2L file. To query these event channel names from the ECU directly, connect to the ECU using mcECUConnect before calling mcGetNames.