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

STM_CM_get_files_list
This function returns the list_of_files into the bank_dir. The size of the list_of_files is then written in the number_of_files.
If there are more than the number_of_files files in the bank_dir, a fail status is returned, and the number_of_files is changed to contain the actual number of files in the bank_dir. A second call to the API is than performed with the actual size for the list_of_files.
Syntax:
int
STM_CM_get_files_list(
const char *bank_dir,
const char *pattern,
int *number_of_files,
char *list_of_files[],
char error_message[1024])
);
Note: Do NOT allow your code to write more than the given number_of_files into the list_of_files parameter, or it will cause memory access violations.