Hitachi

JP1 Version 12 JP1/IT Desktop Management 2 Distribution Function Administration Guide


AIT_FilePutLine

Organization of this page

Description

Writes data into a specified file.

Format

bool AIT_FilePutLine  (
  integer nFileHandle,     // File handle
  string strWriteData      // Data to be written into a file
);

Parameters

nFileHandle (input)

Specify a file handle.

strWriteData (input)

Specify data to be written into a 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 number

Error code

5

ERROR_ACCESS_DENIED

6

ERROR_INVALID_HANDLE

8

ERROR_NOT_ENOUGH_MEMORY

14

ERROR_OUTOFMEMORY

19

ERROR_WRITE_PROTECT

21

ERROR_NOT_READY

32

ERROR_SHARING_VIOLATION

33

ERROR_LOCK_VIOLATION

38

ERROR_HANDLE_EOF

112

ERROR_DISK_FULL

148

ERROR_PATH_BUSY

1231

ERROR_NETWORK_UNREACHABLE

1392

ERROR_FILE_CORRUPT

Notes

If you specify that zero bytes be written, the system considers that null writing operations are specified.

The AIT_FilePutLine function writes data at the current file pointer position, which is updated after writing operations.