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

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

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.

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
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