Ini_GetInt64
- Updated2023-02-21
- 1 minute(s) read
int Ini_GetInt64 (IniText handle, const char sectionName[], const char tagName[], long long *integerValue);
Purpose
Obtains the 64-bit integer value associated with tagName in the section identified by sectionName.
Parameters
| Input | ||
| Name | Type | Description |
| handle | IniText | A handle returned from Ini_New. This handle represents the list of tag/value pairs in memory. |
| sectionName | const char [] | The section name under which to find the tag/value pair. |
| tagName | const char [] | The tag name in the tag/value pair. |
| Output | ||
| Name | Type | Description |
| integerValue | long long | Returns the 64-bit integer value associated with tagName. If the function cannot find the tagName, or the integer value is empty, or an error occurs, the function ignores this variable. |
Return Value
| Name | Type | Description | ||||
| status | int | Indicates whether the function found a valid tag/integer pair with the specified tagName in the section specified by sectionName. A positive return value indicates that a tag/integer pair was found and that the integer portion of the pair was a valid ASCII decimal representation of an integer. A zero indicates that no tag/integer pair was found, or that the integer portion was empty. A negative value indicates an error. If the value is from –1 to –999, it is one of the error values defined in userint.h. If the value is from –5000 to –5999, it is one of the error values defined in toolbox.h. For this function, you might encounter the following errors:
|
Additional Information
Library: Reading/Writing .ini-Style Files
Include file: toolbox\inifile.h
LabWindows/CVI compatibility: LabWindows/CVI 8.5 and later