int RegReadULong (unsigned int rootKey, const char subkeyName[], const char valueName[], unsigned long *uLongData, int dataFormat);
This function reads unsigned 32–bit (unsigned long) data from the specified Key Value in the Windows Registry. You must specify a Root Key, a Subkey of that Root Key, and the actual Value of that Subkey which you want to read.
Example:
unsigned long number;
// Reads the data in MyULongValue in Little–Endian format
RegReadULong (REGKEY_HKLM, "Software\\MySubKey",
"MyULongValue", &number, 0);
Input | ||
Name | Type | Description |
rootKey | unsigned integer | The Root Key under which you wish to access a Subkey and its value. See the Windows Registry functions Class help for more information on Root Keys. |
subkeyName | const char [] | The name of the Subkey (relative to the Root Key), from which you wish to read value data. See the Windows Registry functions Class help for more information on Subkeys. |
valueName | const char [] | The name of the Value from which you want to read data. See the Windows Registry functions Class help for more information on Key Values. |
dataFormat | integer | This parameter specifies how the 32–bit integer is stored in the Registry. Typically, you will specify Little–Endian (Intel) format. |
Output | ||
Name | Type | Description |
uLongData | unsigned long * | Returns the unsigned long contents of the specified Value of the specified Subkey. |
Name | Type | Description |
status | integer | 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. |