RegWriteStringArray
int RegWriteStringArray (unsigned int rootKey, const char subkeyName[], size_t numberOfItems, const char * arrayOfValueNames[], const char * arrayOfStringBuffer[]);
Purpose
This function writes an array of NUL–terminated ASCII strings to the specified Key Values in the Windows Registry. You must specify a Root Key, a Subkey of that Root Key, and names of the actual Values of that Subkey to which you want to write the data.
Example:
static char *valueNames[]={"MyFirstValue",NULL,"MySecondValue"};
static char *values[]={"String1","DefaultValue","String2"};
RegWriteStringArray (REGKEY_HKLM, "Software\\MySubKey", 3, valueNames, values);
(Linux) This function is not supported.
Parameters
| Input | ||
| Name | Type | Description |
| rootKey | unsigned int | The Root Key under which you wish to access a Subkey and its value. See the Windows Registry functions Class help for more information about Root Keys. |
| subkeyName | const char[] | The name of the Subkey (relative to the Root Key), to which you want to write value data. See the Windows Registry functions Class help for more information about Subkeys. |
| numberOfItems | size_t | The number of names and values which you want to write to the Windows Registry. |
| arrayOfValueNames | const char *[] | The array of names of the values to which you want to write data. If any value name does not exist this function will create it. An array element may contain NULL or an empty string if you want to write to the Key's Default Value. See the Windows Registry functions Class help for more information about Key Values. |
| arrayOfStringBuffer | const char *[] | The array of the NULL–terminated ASCII strings you wish to write to the specified Values of the specified Subkey. |
Return Value
| Name | Type | Description |
| status | int | The status code that the function returns. 0 indicates success. A negative value indicates an error. This function may return a Programmer's Toolbox or UI Library error code. Call GetGeneralErrorString to obtain a text description of the error. |
Additional Information
Library: Programmer's Toolbox
Include file: toolbox\toolbox.h
LabWindows/CVI compatibility: LabWindows/CVI 5.5 and later