Defining Third-Party CM Tool Interfaces : User Function Interface to CM Tool : STM_CM_get_versions

STM_CM_get_versions
Returns a list of versions of an archive file (in CM tool format).
Syntax:
STM_CM_get_versions
 
int
STM_CM_get_version(
const char *full_archive_name,
const char *number_of_versions,
const char *versions[],
char error_message[STM_CM_message_length]
);
Note: When the API is called, the number_of_versions parameter specifies the number of possible entries in the versions parameter. The API is expected to set this parameter to the actual number of revisions. If this number is more than the number of possible entries in the versions parameter, the API is called again with the appropriate number of possible entries. If more entries are needed, the function teturns a “fail” status. You cannot specify more than the given number_of_versions value in the versions parameter because it causes memory access violations.