CMA_CTRLINFO

Contains information about the company for which accounting data is to be imported. A filter DLL fills in this structure when the Import Wizard calls the DLL's CMA_FindFirstCompany, CMA_FindNextCompany, and CMA_LoadCompany functions. The CMA_FindFirstCompany and CMA_FindNextCompany functions fill in the szDataPath and szCompanyName members only. The CMA_LoadCompany function uses the szDataPath member to open the company data file, and then it fills in the remaining structure members.

Syntax

typedef struct tagCMA_CTRLINFO {
    HWND    hwndParent;
    DWORD    dwUser;
    DWORD    dwCurrencyCode;
    CHAR    szDescription[256];
    CHAR    szBankAccountNumber[51];
    CHAR    szBankName[51];
    CHAR    szBankRoutingNumber[51];
    CHAR    szDataPath[256];
    CHAR    szOrganizationalIDNumber[51];
    CHAR    szVATIDNumber[51];
    CHAR    szVATIDNumberInternationalPrefix[11];
    CHAR    szBusinessIndustryCode[51];
    SYSTEMTIME    stFiscalYearEnd;
    BOOL    fDualCurrency;
    SYSTEMTIME    stDateModified;
    CHAR    szCompanyName[41];
    CHAR    szNotes[256];
    INT    nFirstFiscalMonth;
    INT    nCurrentFiscalYear;
    INT    nCurrentGLPeriod;
} CMA_CTRLINFO;

hwndParent The handle of the window to use as the parent window of any windows the filter DLL creates. Specifying a parent window ensures the filter's windows have the correct modality.

dwUser Filter-defined data. A filter DLL can use this member for its own purposes.

dwCurrencyCode A value that identifies the currency code of the data being passed to the filter. This can be any of the defined values in Aacommon.h (see list of values at the end of this document). This member is required when the fDualCurrency member of the CMA_CTRLINFO structure is True (must not be NULL).

szDescription A null-terminated string that contains the miscellaneous description for notes on the company.

szBankAccountNumber A null-terminated string that contains the bank account number for the company.

szBankName A null-terminated string that contains the name of the bank for the company.

szBankRoutingNumber A null-terminated string that contains the bank routing number for the company. This member is used for display only, so it may be formatted in whatever way is most appropriate for the intended users.

szDataPath A null-terminated string that contains the data path (path and file name) of the data file for the company. The data path must either identify the data for the company specified by the szCompanyName member or have an ID of some kind that can be parsed by the CMA_LoadCompany function (for example, "C:\Data\Abc.dat:FS," where FS identifies a particular company within C:\Data\Abc.dat).

szOrganizationalIDNumber A null-terminated string that contains the company's organizational ID number. This can be a tax ID number or other tax code number.

szVATIDNumber A null-terminated string that contains the company's VAT/GST tax ID number.

szVATIDNumberInternationalPrefix A null-terminated string that contains the prefix added to the VAT ID number for dealing with international VAT issues.

szBusinessIndustryCode A null-terminated string that contains the appropriate business industry code for the company. This can be SIC, NASIC, or another location-specific industry classification number.

stFiscalYearEnd The end date of the company's fiscal year.

fDualCurrency A multi-currency flag. A return value of True indicates the source data contains two or more currencies.

stDateModified The last date on which this record was modified in the source system. This member is required (must not be NULL).

szCompanyName A null-terminated string that contains the company's name. This name is added to the list of company names in step 3 of the Import Wizard. The name is also used for the file name of the target database and for report headers. This member is required (must not be NULL).

szNotes A null-terminated string that contains user-defined notes.

nFirstFiscalMonth A number that denotes the first month of the fiscal year; 1 = January, 2 = February, and so on.

nCurrentFiscalYear A number that denotes the current fiscal year.

nCurrentGLPeriod A time-period number. This member is used only if the CMA_LoadPackage function set the nEntryStampType member of the CMA_PACKAGE structure to 2 (date method); otherwise, it is ignored. For more information, see the topic, CMA_PACKAGE. For more information about updates, see the Frequently Asked Questions section of Import Filters for the Microsoft Small Business Customer Manager.