На главную

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

RegSetKeySecurity



The RegSetKeySecurity function sets the security of an open registry key.

LONG RegSetKeySecurity(

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


Parameters

hKey

Identifies an open key for which the security descriptor is set.

SecurityInformation

Specifies a SECURITY_INFORMATION structure that indicates the contents of the supplied security descriptor.

Because subkeys are not ordered, any new subkey will have an arbitrary index. This means the function may return subkeys in any order.

pSecurityDescriptor

Points to a SECURITY_DESCRIPTOR structure that specifies the security attributes to set for the specified key.



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

This function succeeds only if the following conditions are met:

· If the key's owner or group is being set, the caller must have WRITE_OWNER permission or have the SE_TAKE_OWNERSHIP_NAME privilege.
· If the key's discretionary access-control list (DACL) is being set, the caller must have WRITE_DAC permission or be the object's owner.
· If the key's system access-control list (SACL) is being set, the caller must have the SE_SECURITY_NAME privilege.



If hKey is one of the predefined keys, the predefined key should be closed with RegCloseKey. That ensures that the new security information is in effect the next time the predefined key is referenced.

See Also

RegCloseKey, RegDeleteKey, RegGetKeySecurity, SECURITY_INFORMATION


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

RegSetKeySecurity



Функция RegSetKeySecurity устанавливает безопасность открытого ключа регистрации.

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

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


Параметры

hKey

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

SecurityInformation

Определяет структуру SECURITY_INFORMATION, которая указывает содержание поставленного дескриптора безопасности.

Поскольку подключи не заказаны, любой новый подключ будет иметь произвольный индекс. Это означает, что функция может возвращать подключи в любой порядок.

pSecurityDescriptor

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



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

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

Замечания

Эта функция добивается успеха только если следующие условия выполнены:

Если ключевой владелец или группа установленн, вызывающий оператор должен иметь разрешение WRITE_OWNER или иметь привилегию SE_TAKE_OWNERSHIP_NAME.
Если ключевой дискреционный иметь доступ к-управляющему списку (DACL), установленн, вызывающий оператор должен иметь разрешение WRITE_DAC или быть объектным владельцем.
Если ключевой системный иметь доступ к-управляющему списку (SACL), установленн, вызывающий оператор должен иметь привилегию SE_SECURITY_NAME.



Если hKey - один из встроенных ключей, встроенный ключ должен быть закрыт RegCloseKey. Это проверяет, что новая информация безопасности - в силе следующий раз встроенная клавиша ссылалась.

Смотри Также

RegCloseKey, RegDeleteKey, RegGetKeySecurity, SECURITY_INFORMATION


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