AIT_InitLog

Description

Initializes a RecDFile.log file to be used by the AIT_LogMessage function. Before executing the AIT_LogMessage function, be sure to execute this function.

The RecDFile.log file exists in the LOG directory path specified by either of the following registry key values.

Format

bool AIT_InitLog  (
 string strMessage     // Message character string
);

Parameters

strMessage (input)

Specify a character string message you want to write into a log file.

Return values

The return value is true if the function was executed normally, and false if not. If the function has returned false, you can use AIT_GetLastError to acquire an extended error code. The following gives the error codes that AIT_GetLastError might return:

Extended error numberError code
3ERROR_PATH_NOT_FOUND
4ERROR_TOO_MANY_OPEN_FILES
5ERROR_ACCESS_DENIED
8ERROR_NOT_ENOUGH_MEMORY
14ERROR_OUTOFMEMORY
19ERROR_WRITE_PROTECT
32ERROR_SHARING_VIOLATION
33ERROR_LOCK_VIOLATION
53ERROR_BAD_NETPATH
82ERROR_CANNOT_MAKE
87ERROR_INVALID_PARAMETER
112ERROR_DISK_FULL
123ERROR_INVALID_NAME
148ERROR_PATH_BUSY
161ERROR_BAD_PATHNAME
183ERROR_ALREADY_EXISTS
206ERROR_FILENAME_EXCED_RANGE
1005ERROR_UNRECOGNIZED_VOLUME
1210ERROR_INVALID_COMPUTERNAME
1214ERROR_INVALID_NETNAME
1231ERROR_NETWORK_UNREACHABLE
1392ERROR_FILE_CORRUPT

Notes

If you have run this function, the previous RecDFile.log is changed to Rec1File.log, with a maximum of five files saved as history.

This function records the current date and time as well as messages.