На главную

On-line справка по Win32 API

Написать письмо
БЕСПЛАТНАЯ ежедневная online лотерея! Выигрывай каждый день БЕСПЛАТНО!
Список всех статей A-B-C-D-E-F-G-H-I-J-K-L-M-N-O-P-Q-R-S-T-U-V-W-X-Y-Z | Скачать Вниз

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

val_list

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


Пригласи друзей и счет твоего мобильника всегда будет положительным!
Предыдущая статья
 
Сайт Народ.Ру Интернет
Следующая статья
Пригласи друзей и счет твоего мобильника всегда будет положительным!

RegQueryMultipleValues



Функция RegQueryMultipleValues извлекает тип и данные для ценных имен списка связанных открытой клавишей регистрации.

ДОЛГО (ДЛИНОЙ) RegQueryMultipleValues(

HKEY hKey, // РУЧКА клавиши на запрос PVALENT val_list, // адрес структур входа ценного массива DWORD num_vals, // размер структур входа ценного массива LPTSTR lpValueBuf, // адреса буфера для информации величины LPDWORD ldwTotsize // адрес ценного буфера размера
);


Параметры

hKey

Идентифицирует к настоящему времени открытую клавишу или любая из pre- определенной резервной ручки оценивает:

HKEY_CLASSES_ROOT HEY_CURRENT_USER HKEY_LOCAL_MACHINE HKEY_USERS

val_list

Адресуйте массив структур VALENT, которые описывают одно или более данных величины. На вводе, ve_valuename элемент каждой структуры должен содержать указатель в имя величины, чтобы извлекаться. Функция терпит неудачу если любая из определенных величин не существуют на определенной клавише.

Если функция добивается успеха, каждый элемент массива содержит информацию для определенной величины.

num_vals

Определяет количество элементов в val_list массиве.

lpValueBuf

Указатель в буфер. Если функция добивается успеха, буфер получает данные для каждой величины.
Если lpValueBuf НЕДЕЙСТВИТЕЛЕН, функция возвращает успех, и ldwTotsize возвращает необходимый размер, в байтах, буфера.

ldwTotsize

Указатель в величину, которая определяет размер, в байтах, буфера указанного, чтобы параметром lpValueBuf. Если функция получает, ldwTotsize возвращает количество байтов скопированных в буфер. Если функция терпит неудачу поскольку буфер слишком небольшой, ldwTotsize получает необходимый размер, в байтах.



Обратные Величины

Если функция добивается успеха, обратная величина - ERROR_SUCCESS.
Если функция терпит неудачу, обратная величина - один из следующих кодов ошибки:

Значение Величины
ERROR_CANTREAD RegQueryMultipleValues не может приписать значение или иметь доступ к поставщику динамической клавиши.
ERROR_MORE_DATA буфер указанный, чтобы lpValueBuf был слишком небольшим. В этом случае, ldwTotsize возвращает необходимый буферный размер.
ERROR_TRANSFER_TOO_LONG общая длина запрошенных данных (размер val_list массива + ldwTotSize), - более, чем системный предел одного мегабайта.


Замечания

Функция RegQueryMultipleValues допускает приложение на запрос одна или более величин статической или динамической клавиши. Если целевая клавиша является статической клавишей, система обеспечивает все величины в атомном способе. Для того, чтобы предохранять чрезмерное преобразование в последовательную форму, составные данные возвращанные функцией не могут превышать один мегабайт.
Если целевая клавиша является динамической клавишей, поставщик должен обеспечить все величины в атомном способе. Это означает, что поставщик должен заполнять буфер результатов синхронно, обеспечивающий последовательный вид всех величин в буфере избегая чрезмерного преобразования в последовательную форму. Поставщик может привести в большинстве одном мегабайте общих выходных данных в течение атомного вызова в эту функцию.

RegQueryMultipleValues ПОДДЕРЖИВАЕТСЯ дистанционно; то есть, параметр hKey пройденный в функцию может ссылаться на дистанционный компьютер.

Смотри Также

VALENT


Вверх Version 1.3, Oct 26 2010 © 2007, 2010, mrhx Вверх
 mrhx software  Русский перевод OpenGL  Русский перевод Win32 API
 
Используются технологии uCoz