Hitachi

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


AIT_GetProfileFirstSection

Organization of this page

Description

Acquires the first key and its value from a specified INI file section.

Format

bool AIT_GetProfileFirstSection  (
  string strIniFileName,     // INI filename
  string strSectionName,     // INI file's section name
  string strValues           // Section data
);

Parameters

strIniFileName (input)

Specify an INI filename.

strSectionName (input)

Specify the name of a section in an INI file.

strValues (output)

Specify a variable to receive a key and its value from a set section. When the function returns, the variable stores a key and its value. A key and its value are combined in the key=value format.

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