acdbValidateSetup

C++

ACDBCORE2D_PORT Acad::ErrorStatus acdbValidateSetup(
    const AcLocale& loc
);

File

dbmain.h

Description

This function must be called early in execution of an RealDWG application. It validates that the application has provided everything that AcDb requires and it does some further setup. There is a contract that RealDWG applications must call acdbValidateSetup() before using AcDb APIs.

The following requirements must be met in order for this function to succeed:

• A valid host application must be registered so that acdbHostApplicationServices() does not return null. If acdbHostApplicationServices::findFile() returns null, then this function fails and returns Acad::eNullObjectPointer.
• The acdb17???res.dll file for the language specified by lcid must be available.

The ??? in the acdb17???res.dll file name is the three letter language abbreviation obtained from the Win32 API function GetLocaleInfo() for the locale specified by loc. To locate acdb17???res.dll, this function first uses AcDbHostApplicationServices::findFile(). If that fails, then this function assumes the resource DLL is in the same directory as acdb17.dll. If findFile() fails and the resource DLL is not in the same directory as acdb17.dll, then this function fails and returns Acad::eFileNotFound.

Parameters