Retrieves the next company name and data path from the data file specified by the szFilename parameter of the CMA_FindFirstCompany function. It then copies the name and path to the specified CMA_CTRLINFO structure.
Syntax
BOOL CMA_FindNextCompany(CMA_CTRLINFO& CtrlInfo);
CtrlInfo The address of the CMA_CTRLINFO structure into which the filter DLL copies the company name and data path. The CMA_FindNextCompany function fills in only the szCompanyName and szDataPath members of the CMA_CTRLINFO structure. The CMA_LoadCompany function uses szDataPath to open the company data, and then it fills in the remaining members of the structure.
Return Values
True if the specified file contains additional companies; False if there are no more company records to process in the file.
Remarks
After calling the CMA_FindFirstCompany function, the Import Wizard calls the CMA_FindNextCompany function repeatedly until it returns False, which which indicatesindicates that it has provided information for all the companies. This makes it possible to identify multiple companies in a single data file.
If a file passed to the CMA_FindFirstCompany function identifies multiple companies, the CMA_FindNextCompany function is typically where the filter DLL loads the company name and data path. In this case, CMA_FindFirstCompany just calls CMA_FindNextCompany after preparing to read the names of the companies listed in the file.
See Also