Hitachi

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


AIT_GetProfileString

Organization of this page

Description

Acquires the value of a specified key from a section in a specified INI file.

Format

bool AIT_GetProfileString  (
  string strIniFileName,     // INI filename
  string strSectionName,     // Section name
  string strKeyName,         // Key name
  string strValue            // Key value
);

Parameters

strIniFileName (input)

Specify an INI filename.

strSectionName (input)

Specify a section name in an INI file.

strKeyName (input)

Specify a key name belonging to a section name.

strValue (output)

Specify a variable to receive a key value. When the function returns, the variable stores the key value.

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

2

ERROR_FILE_NOT_FOUND

3

ERROR_PATH_NOT_FOUND

5

ERROR_ACCESS_DENIED

6

ERROR_INVALID_HANDLE

8

ERROR_NOT_ENOUGH_MEMORY

14

ERROR_OUTOFMEMORY

15

ERROR_INVALID_DRIVE

21

ERROR_NOT_READY

38

ERROR_HANDLE_EOF

53

ERROR_BAD_NETPATH

87

ERROR_INVALID_PARAMETER

112

ERROR_DISK_FULL

123

ERROR_INVALID_NAME

148

ERROR_PATH_BUSY

161

ERROR_BAD_PATHNAME

998

ERROR_NOACCESS

1005

ERROR_UNRECOGNIZED_VOLUME

1169

ERROR_NO_MATCH

1210

ERROR_INVALID_COMPUTERNAME

1214

ERROR_INVALID_NETNAME

1231

ERROR_NETWORK_UNREACHABLE