На главную

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

RegGetKeySecurity



The RegGetKeySecurity function retrieves a copy of the security descriptor protecting the specified open registry key.

LONG RegGetKeySecurity(

HKEY hKey, // open handle of key to set
SECURITY_INFORMATION SecurityInformation, // descriptor contents
PSECURITY_DESCRIPTOR pSecurityDescriptor, // address of descriptor for key
LPDWORD lpcbSecurityDescriptor // address of size of buffer and descriptor
);


Parameters

hKey

Identifies an open key for which to retrieve the security descriptor.

SecurityInformation

Specifies a SECURITY_INFORMATION structure that indicates the requested security information.

pSecurityDescriptor

Points to a buffer that receives a copy of the requested security descriptor.

lpcbSecurityDescriptor

Points to a variable that specifies the size, in bytes, of the buffer pointed to by the pSecurityDescriptor parameter. When the function returns, the variable contains the number of bytes written to the buffer.



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

If the buffer specified by the pSecurityDescriptor parameter is too small, the function returns ERROR_INSUFFICIENT_BUFFER and the lpcbSecurityDescriptor parameter contains the number of bytes required for the requested security descriptor.
To read the security descriptor for the specified key, the calling process must have been granted READ_CONTROL access when the key was opened, or it must be the owner of the key. (READ_CONTROL access is granted by the KEY_READ, KEY_WRITE, KEY_EXECUTE, and KEY_ALL_ACCESS access rights.) In addition, the caller must have the SE_SECURITY_NAME privilege to read the system access-control list (SACL).

For more information about security, see Security.

See Also

RegDeleteKey, RegOpenKeyEx, RegSetKeySecurity, SECURITY_INFORMATION


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

RegGetKeySecurity



Функция RegGetKeySecurity извлекает копию дескриптора безопасности, защищающей определенный открытый ключ регистрации.

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

HKEY hKey, // ОТКРЫТАЯ ручка ключа, чтобы устанавливать SECURITY_INFORMATION SecurityInformation, // содержание дескриптора PSECURITY_DESCRIPTOR pSecurityDescriptor, // адреса дескриптора для ключевого lpcbSecurityDescriptor / LPDWORD/ адрес размера буфера и дескриптора
);


Параметры

hKey

Идентифицирует открытый ключ для которого, чтобы извлекать дескриптор безопасности.

SecurityInformation

Определяет структуру SECURITY_INFORMATION, которая указывает запрошенную информацию безопасности.

pSecurityDescriptor

Точки на буфер, которые получают копию запрошенного дескриптора безопасности.

lpcbSecurityDescriptor

Точки на переменную, которые определяют размер, в байтах, буфера указанного, чтобы параметром pSecurityDescriptor. Когда функция возвращается, переменная содержит количество байтов записанных в буфер.



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

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

Замечания

Если буфер определенный параметром pSecurityDescriptor слишком небольшой, функция возвращает ERROR_INSUFFICIENT_BUFFER и параметр lpcbSecurityDescriptor содержит количество байтов необходимое для запрошенного дескриптора безопасности.
Чтобы читать дескриптор безопасности для определенной клавиши, вызов процесса по-видимому предоставляют доступ READ_CONTROL когда клавиша была открыта, или это должно быть владельцем клавиши. (доступу READ_CONTROL предоставляют KEY_READ, KEY_WRITE, KEY_EXECUTE, и правами доступа KEY_ALL_ACCESS.) Кроме того, вызывающий оператор должен иметь привилегию SE_SECURITY_NAME, чтобы читать системный иметь доступ к-управляющему списку (SACL).

Более подробно о безопасности, смотри Безопасность.

Смотри Также

RegDeleteKey, RegOpenKeyEx, RegSetKeySecurity, SECURITY_INFORMATION


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