Ini_PutUInt
- Updated2023-02-21
- 2 minute(s) read
int Ini_PutUInt (IniText handle, const char sectionName[], const char tagName[], unsigned int unsignedIntegerValue);
Purpose
Adds a tag/unsigned integer pair to the tag/value list identified by handle. The unsigned integer value is associated with the tag identified by tagName in the section identified by sectionName.
 |
Note By default, the function checks for and deletes existing items with duplicate names. You can disable the duplicate checking, and thereby increase performance, by calling Ini_SetDuplicateChecking. |
Parameters
| Input | ||
| Name | Type | Description |
| handle | IniText | A handle returned from Ini_New. It represents the list of in-memory tag/value pairs. |
| sectionName | const char [] | The section name under which to place the tag/value pair. |
| tagName | const char [] | The tag name to use in the tag/value pair. |
| unsignedIntegerValue | unsigned int | The unsigned integer value to associate with the Tag Name. |
Return Value
| Name | Type | Description | ||
| status | int | Indicates whether the function was successful. A zero indicates success. 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, the only error you are likely to encounter is:
|
Additional Information
Library: Reading/Writing .ini-Style Files
Include file: toolbox\inifile.h
LabWindows/CVI compatibility: LabWindows/CVI 4.0 and later