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 |
); |
HKEY_CLASSES_ROOT
HKEY_CURRENT_CONFIG
HKEY_CURRENT_USER
HKEY_LOCAL_MACHINE
HKEY_USERS
Windows NT only: HKEY_PERFORMANCE_DATA
Windows 95 only: HKEY_DYN_DATA
If the function succeeds, each element of the array contains the information
for the specified value.
If lpValueBuf is NULL, the function returns success, and ldwTotsize
returns the required size, in bytes, of the buffer.
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. |
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.
file: /Techref/os/win/api/win32/func/src/f73_6.htm, 5KB, , updated: 2000/4/7 11:19, local time: 2024/11/5 06:36,
18.226.164.82:LOG IN ©2024 PLEASE DON'T RIP! THIS SITE CLOSES OCT 28, 2024 SO LONG AND THANKS FOR ALL THE FISH!
|
©2024 These pages are served without commercial sponsorship. (No popup ads, etc...).Bandwidth abuse increases hosting cost forcing sponsorship or shutdown. This server aggressively defends against automated copying for any reason including offline viewing, duplication, etc... Please respect this requirement and DO NOT RIP THIS SITE. Questions? <A HREF="http://linistepper.com/techref/os/win/api/win32/func/src/f73_6.htm"> RegQueryMultipleValues</A> |
Did you find what you needed? |