На главную

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

SetNamedSecurityInfo



[New - Windows NT]

The SetNamedSecurityInfo function sets specified security information in the security descriptor of a specified object. The caller identifies the object by name.

DWORD SetNamedSecurityInfo(

LPTSTR pObjectName, // name of the object
SE_OBJECT_TYPE ObjectType, // type of object
SECURITY_INFORMATION SecurityInfo, // type of security information to set
PSID psidOwner, // pointer to the new owner SID
PSID psidGroup, // pointer to the new primary group SID
PACL pDacl, // pointer to the new DACL
PACL pSacl // pointer to the new SACL
);


Parameters

pObjectName

Pointer to a null-terminated string that specifies the name of the object for which to set security information. This can be the name of a local or remote file or directory on a NTFS file system, Windows NT network sharename, registry key, semaphore, event, mutex, file mapping, or waitable timer.
For descriptions of the string formats for the different object types, see SE_OBJECT_TYPE.

ObjectType

Specifies a value from the SE_OBJECT_TYPE enumeration that indicates the type of object named by the pObjectName parameter.

SecurityInfo

A set of SECURITY_INFORMATION bit flags that indicate the type of security information to set. This parameter can be a combination of the following values.

Value Meaning
OWNER_SECURITY_INFORMATION Set the owner security identifier (SID) in the object's security descriptor. The psidOwner parameter points to the new SID.
GROUP_SECURITY_INFORMATION Set the primary group SID in the object's security descriptor. The psidGroup parameter points to the new SID.
DACL_SECURITY_INFORMATION Set the discretionary access-control list (DACL) in the object's security descriptor. The pDacl parameter points to the new DACL.
SACL_SECURITY_INFORMATION Set the system access-control list (SACL) in the object's security descriptor. The pSacl parameter points to the new SACL.


psidOwner

Pointer to a SID that identifies the object's owner. The SID must be one that can be assigned as the owner SID of a security descriptor. The SecurityInfo parameter must include the OWNER_SECURITY_INFORMATION flag. The caller must have WRITE_OWNER access to the object or have the SE_TAKE_OWNERSHIP_NAME privilege enabled. This parameter can be NULL if you are not setting the owner SID.

psidGroup

Pointer to a SID that identifies the object's primary group. The SecurityInfo parameter must include the GROUP_SECURITY_INFORMATION flag. This parameter can be NULL if you are not setting the primary group SID.

pDacl

Pointer to the new DACL for the object. The SecurityInfo parameter must include the DACL_SECURITY_INFORMATION flag. The caller must have WRITE_DAC access to the object or be the object's owner. This parameter can be NULL if you are not setting the DACL.

pSacl

Pointer to the new SACL for the object. The SecurityInfo parameter must include the SACL_SECURITY_INFORMATION flag. The caller must have the SE_SECURITY_NAME privilege enabled. This parameter can be NULL if you are not setting the SACL.



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.

See Also

ACL, GetNamedSecurityInfo, GetSecurityInfo, SE_OBJECT_TYPE, SECURITY_DESCRIPTOR, SECURITY_INFORMATION, SetSecurityInfo, SID


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

SetNamedSecurityInfo



[Новый - Windows NT]

Функция SetNamedSecurityInfo устанавливает определенную информацию безопасности в дескрипторе безопасности определенного объекта. Вызывающий оператор идентифицирует объект по имени.

DWORD SetNamedSecurityInfo(

LPTSTR pObjectName, // ИМЯ объекта SE_OBJECT_TYPE ObjectType, // типа объекта SECURITY_INFORMATION SecurityInfo, // типа информации безопасности, чтобы устанавливать PSID psidOwner, // указателю новому владельцу SID PSID psidGroup, // указателю в новую первичную группу SID PACL pDacl, // указатель на новый указатель DACL PACL pSacl // на новый SACL
);


Параметры

pObjectName

Указатель в недействительный расторгнутую строку, которая определяет имя объекта для которого, чтобы устанавливать информацию безопасности. Это может быть именем локального или дистанционного файла или директория в файловой системе NTFS, сеть Windows NT sharename, клавиша регистрации, семафора, события, mutex, файлового распределения, или waitable таймере.
Для описаний форматов строки для других объектных типов, смотри SE_OBJECT_TYPE.

ObjectType

Определяет величину из перечисления SE_OBJECT_TYPE, которое указывает тип объекта назывался параметром pObjectName.

SecurityInfo

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

Значение Величины
OWNER_SECURITY_INFORMATION Установлен идентификатор безопасности владельца (SID) в объектном дескрипторе безопасности. Параметр psidOwner указывает на новый SID.
GROUP_SECURITY_INFORMATION Установлен первичная группа SID в объектном дескрипторе безопасности. Параметр psidGroup указывает на новый SID.
DACL_SECURITY_INFORMATION Установлен дискреционным иметь доступ к-управляющему списку (DACL) в объектном дескрипторе безопасности. Параметр pDacl указывает на новый DACL.
SACL_SECURITY_INFORMATION Установлен системным иметь доступ к-управляющему списку (SACL) в объектном дескрипторе безопасности. Параметр pSacl указывает на новый SACL.


psidOwner

Указатель на SID, которое идентифицирует объектного владельца. SID Должен быть тем который может быть назначен как владелец SID дескриптора безопасности. Параметр SecurityInfo должен включить флаг OWNER_SECURITY_INFORMATION. Вызывающий оператор должен иметь доступ WRITE_OWNER к объекту или приспособилось привилегию SE_TAKE_OWNERSHIP_NAME. Этот параметр может быть НЕДЕЙСТВИТЕЛЕН если Вы не устанавливаете владельца SID.

psidGroup

Указатель на SID, которое идентифицирует объектную первичную группу. Параметр SecurityInfo должен включить флаг GROUP_SECURITY_INFORMATION. Этот параметр может быть НЕДЕЙСТВИТЕЛЕН если Вы не устанавливаете первичную группу SID.

pDacl

Указатель на новый DACL для объекта. Параметр SecurityInfo должен включить флаг DACL_SECURITY_INFORMATION. Вызывающий оператор должен иметь доступ WRITE_DAC к объекту или быть объектным владельцем. Этот параметр может быть НЕДЕЙСТВИТЕЛЕН если Вы не устанавливаете DACL.

pSacl

Указатель на новый SACL для объекта. Параметр SecurityInfo должен включить флаг SACL_SECURITY_INFORMATION. Вызывающий оператор должен приспособиться привилегию SE_SECURITY_NAME. Этот параметр может быть НЕДЕЙСТВИТЕЛЕН если Вы не устанавливаете SACL.



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

Если функция добивается успеха, обратная величина - ERROR_SUCCESS.
Если функция терпит неудачу, обратная величина является ненулевым кодом ошибки определенным в WINERROR.H.

Смотри Также

ACL, GetNamedSecurityInfo, GetSecurityInfo, SE_OBJECT_TYPE, SECURITY_DESCRIPTOR, SECURITY_INFORMATION, SetSecurityInfo, SID


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