Job Management Partner 1/Software Distribution Automatic Installation Tool Description and Reference

[Contents][Glossary][Index][Back][Next]

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 may return.

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

Notes

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

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