|
Overview |
|
|
|
Group |
|
|
|
Quick Info
Windows NT
| Yes
| Win95
| Yes
| Win32s
| No
| Import Library
| kernel32.lib
| Header File
| winreg.h
| Unicode
| WinNT
| Platform Notes
| None
|
|
|
RegQueryMultipleValues
The RegQueryMultipleValues function retrieves the type and data for a list of value names associated
with an open registry key.
LONG RegQueryMultipleValues(
HKEY hKey,
| // handle of key to query
| PVALENT val_list,
| // address of array of value entry structures
| DWORD num_vals,
| // size of array of value entry structures
| LPTSTR lpValueBuf,
| // address of buffer for value information
| LPDWORD ldwTotsize
| // address of size of value buffer
| );
|
|
Parameters
hKey
Identifies a currently open key or any of the pre-defined reserved handle
values:
HKEY_CLASSES_ROOT
HEY_CURRENT_USER
HKEY_LOCAL_MACHINE
HKEY_USERS
Address of an array of VALENT structures that describe one or more value entries. On input, the ve_valuename member of each structure must contain a pointer to the name of a value to
retrieve. The function fails if any of the specified values do not exist in the
specified key.
If the function succeeds, each element of the array contains the information
for the specified value.
num_vals
Specifies the number of elements in the val_list array.
lpValueBuf
Pointer to a buffer. If the function succeeds, the buffer receives the data
for each value.
If lpValueBuf is NULL, the function returns success, and ldwTotsize returns the required size, in bytes, of the buffer.
ldwTotsize
Pointer to a value that specifies the size, in bytes, of the buffer pointed to
by the lpValueBuf parameter. If the function succeeds, ldwTotsize returns the number of bytes copied to the buffer. If the function fails
because the buffer is too small, ldwTotsize receives the required size, in bytes.
Return Values
If the function succeeds, the return value is ERROR_SUCCESS.
If the function fails, the return value is one of the following error codes:
Value
| Meaning
| ERROR_CANTREAD
| RegQueryMultipleValues cannot instantiate or access the provider of the dynamic key.
| ERROR_MORE_DATA
| The buffer pointed to by lpValueBuf was too small. In this case, ldwTotsize returns the required buffer size.
| ERROR_TRANSFER_TOO_LONG
| The total length of the requested data (size of the val_list array + ldwTotSize) is more than the system limit of one megabyte.
|
Remarks
The RegQueryMultipleValues function allows an application to query one or more values of a static or
dynamic key. If the target key is a static key, the system provides all of the
values in an atomic fashion. To prevent excessive serialization, the aggregate
data returned by the function can not exceed one megabyte.
If the target key is a dynamic key, its provider must provide all the values
in an atomic fashion. This means the provider should fill the results buffer
synchronously, providing a consistent view of all the values in the buffer while
avoiding excessive serialization. The provider can provide at most one megabyte
of total output data during an atomic call to this function.
RegQueryMultipleValues is supported remotely; that is, the hKey parameter passed to the function can refer to a remote computer.
See Also
VALENT
| Last news from Greatis Software |
 |
|
Nostalgia .Net |
|
.Net is powerful, but not all-powerful, so sometimes we need to use Win32 API for our .Net applications. It's simple enough with Platform Invoke if you have Win32 skill, but we do not always have time to dig the ancient documentation, declare the special types that are compatible with Win32, find the values of the Win32's constants and so on. Nostalgia .Net offers several simple-to-use classes, and components that will allow you to forget about the headache of Win32 and just use the power of Win32 in your application the same way as you use the native. Net classes. More » |
| Recommended software for developers |
 |
|
Ultimate Pack |
|
Component pack for Delphi and C++ Builder that contains runtime form designer, runtime object inspector, print suite and much more for the very special price. More » |
 |
|
Form Designer .Net |
|
Unique runtime form design solution that allows to edit any form in .Net WinForms application at runtime with full source codes for only 300 euro! More » |
 |
|
Print Suite .Net |
|
Print Suite .Net is a set of components for easy printing texts, images and grids from your WinForms applications. Full C# source codes are available More » |
 |
|
Gradient Controls .Net |
|
Gradient Controls .Net offers controls with gradient background feature. Labels, panels and so on... Full C# source codes are available More » |
 |
|
Greatis iGrid |
|
iGrid plots drawing grid right over your desktop, so you can use it everywhere, with any drawing application without any special plugins for different graphic editors. More » |
All the contacts and projectsDmitry Vasiliev (just.dmitry)
Related LinksSoftware for Visual Studio .NET developers
Software for Delphi and C++ Builder developers
Software for Visual Basic 6 developers
Delphi Tips&Tricks
MegaDetailed.NET More Online Helps Win32 Programmer's Reference
Win32 Multimedia Programmer's Reference
OLE Programmer's Reference
Microsoft Windows Pen API Programmer's Reference
Microsoft Windows Sockets 2 Reference
Microsoft Windows Telephony API (TAPI) Programmer's Reference
Unix Manual Pages
|
