На главную

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 | Скачать Вниз

RegQueryInfoKey



The RegQueryInfoKey function retrieves information about a specified registry key.

LONG RegQueryInfoKey (

HKEY hKey, // handle of key to query
LPTSTR lpClass, // address of buffer for class string
LPDWORD lpcbClass, // address of size of class string buffer
LPDWORD lpReserved, // reserved
LPDWORD lpcSubKeys, // address of buffer for number of subkeys
LPDWORD lpcbMaxSubKeyLen, // address of buffer for longest subkey name length
LPDWORD lpcbMaxClassLen, // address of buffer for longest class string length
LPDWORD lpcValues, // address of buffer for number of value entries
LPDWORD lpcbMaxValueNameLen, // address of buffer for longest value name length
LPDWORD lpcbMaxValueLen, // address of buffer for longest value data length
LPDWORD lpcbSecurityDescriptor, // address of buffer for security descriptor length
PFILETIME lpftLastWriteTime // address of buffer for last write time
);


Parameters

hKey

Identifies a currently open key or any of the following predefined reserved handle values:

HKEY_CLASSES_ROOT
HKEY_CURRENT_USER
HKEY_LOCAL_MACHINE
HKEY_USERS

lpClass

Points to a buffer that receives the key's class name. This parameter can be NULL.

lpcbClass

Points to a variable that specifies the size, in characters, of the buffer pointed to by the lpClass parameter. This size should include the terminating null character. When the function returns, this variable contains the length of the class string stored in the buffer. The count returned does not include the terminating null character. If the buffer is not big enough, the function returns ERROR_MORE_DATA, and the variable contains the size of the string, in characters, without counting the null character.

If lpClass is NULL, lpcbClass can be NULL.
Windows NT: If the lpClass parameter is a valid address, but the lpcbClass parameter is not (for example, it is NULL), the function returns ERROR_INVALID_PARAMETER.
Windows 95: If the lpClass parameter is a valid address, but the lpcbClass parameter is not (for example, it is NULL), the function returns ERROR_SUCCESS instead of ERROR_INVALID_PARAMETER. To ensure compatibility with other platforms, verify that lpcbClass is valid before calling the function.

lpReserved

Reserved; must be NULL.

lpcSubKeys

Points to a variable that receives the number of subkeys contained by the specified key. This parameter can be NULL.

lpcbMaxSubKeyLen

Points to a variable that receives the length, in characters, of the key's subkey with the longest name. The count returned does not include the terminating null character. This parameter can be NULL.

lpcbMaxClassLen

Points to a variable that receives the length, in characters, of the longest string specifying a subkey class. The count returned does not include the terminating null character. This parameter can be NULL.

lpcValues

Points to a variable that receives the number of values associated with the key. This parameter can be NULL.

lpcbMaxValueNameLen

Points to a variable that receives the length, in characters, of the key's longest value name. The count returned does not include the terminating null character. This parameter can be NULL.

lpcbMaxValueLen

Points to a variable that receives the length, in bytes, of the longest data component among the key's values. This parameter can be NULL.

lpcbSecurityDescriptor

Points to a variable that receives the length, in bytes, of the key's security descriptor. This parameter can be NULL.

lpftLastWriteTime

Pointer to a FILETIME structure. This parameter can be NULL.

If you are querying the registry on a computer running Windows NT, the function sets the members of the FILETIME structure to indicate the last time that the key or any of its value entries was modified.
If you are querying the registry on a computer running Windows 95, the function sets the members of the FILETIME structure to zero. This is because the Windows 95 operating system does not keep track of registry key last write time information.



Return Values

If the function succeeds, the return value is ERROR_SUCCESS.
If the function fails, the return value is a nonzero error code defined in WINERROR.H. You can use the FormatMessage function with the FORMAT_MESSAGE_FROM_SYSTEM flag to get a generic description of the error.

Remarks

The key identified by the hKey parameter must have been opened with KEY_QUERY_VALUE access (KEY_READ access includes KEY_QUERY_VALUE access).

See Also

FILETIME, RegDeleteKey, RegEnumKey, RegEnumKeyEx, RegEnumValue, RegQueryValue, RegQueryValueEx


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

RegQueryInfoKey



Функция RegQueryInfoKey извлекает информацию об определенной клавише регистрации.

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

HKEY hKey, // РУЧКА клавиши на запрос LPTSTR lpClass, // адрес буфера для строки класса LPDWORD lpcbClass, // адрес размера буфера строки класса LPDWORD lpReserved, // зарезервировавшее LPDWORD lpcSubKeys, // адрес буфера для количества подключей LPDWORD lpcbMaxSubKeyLen, // адреса буфера для длины имени самого длинного подключа LPDWORD lpcbMaxClassLen, // адреса буфера для длины строки самого длинного класса LPDWORD lpcValues, // адреса буфера для ценных данных числа LPDWORD lpcbMaxValueNameLen, // адреса буфера для длины имени самой длинной величины LPDWORD lpcbMaxValueLen, // адреса буфера для длины данных самого длинного lpcbSecurityDescriptor величины LPDWORD, // адреса буфера для длины дескриптора адреса безопасности PFILETIME lpftLastWriteTime // буфера в течение последнего записывать времени
);


Параметры

hKey

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

HKEY_CLASSES_ROOT HKEY_CURRENT_USER HKEY_LOCAL_MACHINE HKEY_USERS

lpClass

Точки на буфер, которые получают ключевое имя класса. Этот параметр может быть НЕДЕЙСТВИТЕЛЕН.

lpcbClass

Точки на переменную, которые определяют размер, в символах, буфера указанного, чтобы параметром lpClass. Этот размер должен включить завершающий недействительный символ. Когда функция возвращается, эта переменная содержит длину строки класса загруженного в буфер. Счет не возвращал включает завершающий недействительный символ. Если буфер не является большой достаточно, функциональный возврат ERROR_MORE_DATA, и переменная содержит размер строки, в символах, не считая недействительный символ.

Если lpClass НЕДЕЙСТВИТЕЛЕН, lpcbClass может быть НЕДЕЙСТВИТЕЛЕН.
Windows NT: Если параметр lpClass является правильным адресом, но параметр lpcbClass - не (например, он НЕДЕЙСТВИТЕЛЕН), функциональный возврат ERROR_INVALID_PARAMETER.
Windows 95: Если параметр lpClass является правильным адресом, но параметр lpcbClass - не (например, он НЕДЕЙСТВИТЕЛЕН), функциональный возврат ERROR_SUCCESS вместо ERROR_INVALID_PARAMETER. Для того, чтобы гарантировать совместимость с другими платформами, проверьте, что lpcbClass - в силе перед вызовом функции.

lpReserved

Зарезервированное; должно быть НЕДЕЙСТВИТЕЛЬНО.

lpcSubKeys

Точки на переменную, которые получают количество подключей содержал определенной клавишей. Этот параметр может быть НЕДЕЙСТВИТЕЛЕН.

lpcbMaxSubKeyLen

Точки на переменную, которые получают длину, в символах, ключевого подключа с самым длинным именем. Счет не возвращал включает завершающий недействительный символ. Этот параметр может быть НЕДЕЙСТВИТЕЛЕН.

lpcbMaxClassLen

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

lpcValues

Точки на переменную, которые получают количество величин связывался клавишей. Этот параметр может быть НЕДЕЙСТВИТЕЛЕН.

lpcbMaxValueNameLen

Точки на переменную, которые получают длину, в символах, ключевого самого длинного имени величины. Счет не возвращал включает завершающий недействительный символ. Этот параметр может быть НЕДЕЙСТВИТЕЛЕН.

lpcbMaxValueLen

Точки на переменную, которые получают длину, в байтах, самого длинного компонента данных среди ключевых величин. Этот параметр может быть НЕДЕЙСТВИТЕЛЕН.

lpcbSecurityDescriptor

Точки на переменную, которые получают длину, в байтах, ключевого дескриптора безопасности. Этот параметр может быть НЕДЕЙСТВИТЕЛЕН.

lpftLastWriteTime

Указатель в структуру FILETIME. Этот параметр может быть НЕДЕЙСТВИТЕЛЕН.

Если Вы спрашиваете регистрацию в компьютере, выполняющем Windows NT, функция устанавливает участников структуры FILETIME, чтобы указывать в последний раз, что клавиша или любое из своих данных величины были модифицированы.
Если Вы спрашиваете регистрацию в компьютере, выполняющем Windows 95, функция устанавливает участников структуры FILETIME в нуль. Дело в том, что операционная система Windows 95 не следит ключевой последней записи времени регистрации информации.



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

Если функция добивается успеха, обратная величина - ERROR_SUCCESS.
Если функция терпит неудачу, обратная величина является ненулевым кодом ошибки определенным в WINERROR.H. Вы можете использовать функцию FormatMessage с флагом FORMAT_MESSAGE_FROM_SYSTEM, чтобы получать общее описание ошибки.

Замечания

Клавиша идентифицированная параметром hKey по-видимому открыта доступом KEY_QUERY_VALUE (доступ KEY_READ включает доступ KEY_QUERY_VALUE).

Смотри Также

FILETIME, RegDeleteKey, RegEnumKey, RegEnumKeyEx, RegEnumValue, RegQueryValue, RegQueryValueEx


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