На главную

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

BuildExplicitAccessWithName



[New - Windows NT]

The BuildExplicitAccessWithName function initializes an EXPLICIT_ACCESS structure with data specified by the caller. The trustee is identified by a name string.

VOID BuildExplicitAccessWithName(

PEXPLICIT_ACCESS pExplicitAccess, // pointer to the structure to initialize
LPTSTR pTrusteeName, // name of the trustee to put in the structure
DWORD AccessPermissions, // access mask to put in the structure
ACCESS_MODE AccessMode, // access mode to put in the structure
DWORD Inheritance // inheritance type to put in the structure
);


Parameters

pExplicitAccess

Pointer to an EXPLICIT_ACCESS structure to initialize. BuildExplicitAccessWithName does not allocate any memory. If this parameter is NULL, the function does nothing.

pTrusteeName

Pointer to a null-terminated string that contains the name of the trustee for the ptstrName member of the TRUSTEE structure. The BuildExplicitAccessWithName function sets the other members of the TRUSTEE structure as follows:

Member Value
pMultipleTrustee NULL
MultipleTrusteeOperation NO_MULTIPLE_TRUSTEE
TrusteeForm TRUSTEE_IS_NAME
TrusteeType TRUSTEE_IS_UNKNOWN


AccessPermissions

Specifies an access mask for the grfAccessPermissions member of the EXPLICIT_ACCESS structure. The mask is a set of bit flags that use the ACCESS_MASK format to specify the access rights that an ACE allows, denies, or audits for the trustee. The functions that use the EXPLICIT_ACCESS structure do not convert, interpret, or validate the bits in this mask.

AccessMode

Specifies an access mode for the grfAccessMode member of the EXPLICIT_ACCESS structure. The access mode indicates whether the ACE allows, denies, or audits the specified rights. This parameter contains values from the ACCESS_MODE enumeration.

Inheritance

Specifies an inheritance type for the grfInheritance member of the EXPLICIT_ACCESS structure. This value is a set of bit flags that determines whether other containers or objects can inherit the ACE from the primary object to which the ACL is attached. The value of this member corresponds to the inheritance portion (low-order byte) of the AceFlags member of the ACE_HEADER structure. This parameter can be NO_INHERITANCE to indicate that the ACE is not inheritable,or it can be a combination of the following values.

Value Meaning
CONTAINER_INHERIT_ACE
Other containers that are contained by the primary object inherit the ACE.
INHERIT_ONLY_ACE
The ACE does not apply to the primary object to which the ACL is attached, but objects contained by the primary object inherit the ACE.
NO_PROPAGATE_INHERIT_ACE
The OBJECT_INHERIT_ACE and CONTAINER_INHERIT_ACE flags are not propagated to an inherited ACE.
OBJECT_INHERIT_ACE
Noncontainer objects contained by the primary object inherit the ACE.
SUB_CONTAINERS_ONLY_INHERIT
Other containers that are contained by the primary object inherit the ACE. This flag corresponds to the CONTAINER_INHERIT_ACE flag.
SUB_OBJECTS_ONLY_INHERIT
Noncontainer objects contained by the primary object inherit the ACE. This flag corresponds to the OBJECT_INHERIT_ACE flag.
SUB_CONTAINERS_AND_OBJECTS_INHERIT
Both containers and noncontainer objects that are contained by the primary object inherit the ACE. This flag corresponds to the combination of the CONTAINER_INHERIT_ACE and OBJECT_INHERIT_ACE flags.


Return Values

None.

See Also

ACE, ACL, EXPLICIT_ACCESS, GetExplicitEntriesFromAcl, SetEntriesInAcl, TRUSTEE


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

BuildExplicitAccessWithName



[Новый - Windows NT]

Функция BuildExplicitAccessWithName инициализирует структуру EXPLICIT_ACCESS с данными определенными вызывающим оператором. Попечитель называется строкой имени.

ПУСТОТА BuildExplicitAccessWithName(

PEXPLICIT_ACCESS pExplicitAccess, // указатель в структуру, чтобы инициализировать LPTSTR pTrusteeName, // имя попечителя, чтобы вкладывать структуру DWORD AccessPermissions, // маску доступа, чтобы вкладывать структуру ACCESS_MODE AccessMode, // режим доступа, чтобы вкладывать структурное Наследство / DWORD/ тип наследства, чтобы вкладывать структуру
);


Параметры

pExplicitAccess

Указатель в структуру EXPLICIT_ACCESS, чтобы инициализироваться. BuildExplicitAccessWithName НЕ распределяет любую память. Если этот параметр НЕДЕЙСТВИТЕЛЕН, функция делает ничто.

pTrusteeName

Указатель в недействительный расторгнутую строку, которая содержит имя попечителя для элемента ptstrName структуры ПОПЕЧИТЕЛЯ. Функция BuildExplicitAccessWithName устанавливает других участников структуры ПОПЕЧИТЕЛЯ следующим образом:

Величина Элемента pMultipleTrustee NULL MultipleTrusteeOperation NO_MULTIPLE_TRUSTEE TrusteeForm TRUSTEE_IS_NAME TrusteeType TRUSTEE_IS_UNKNOWN


AccessPermissions

Определяет маску доступа для элемента grfAccessPermissions структуры EXPLICIT_ACCESS. Маска является установкой битовых флагов, которые используют формат ACCESS_MASK, чтобы определять права доступа, что АС допускает, запрещит, или проверяется для попечителя. Функции, которые используют структуру EXPLICIT_ACCESS не преобразовывают, интерпретируют, или подтверждают биты в этой маске.

AccessMode

Определяет режим доступа для элемента grfAccessMode структуры EXPLICIT_ACCESS. Режим доступа указывает допускает АС, запрещит, или проверяет определенные права. Этот параметр содержит величины из перечисления ACCESS_MODE.

Наследство

Определяет тип наследства для элемента grfInheritance структуры EXPLICIT_ACCESS. Эта величина является установкой битовых флагов, которые определяют независимо другие контейнеры или возражают, может унаследовать АСА с первичного объекта против которого ACL приложен. Величина этого элемента переписывается в часть наследства (младший байт) элемента AceFlags структуры ACE_HEADER. Этот параметр может быть NO_INHERITANCE, чтобы указывать, что АС - не inheritable,или это может быть комбинацией следующего величин.

Оцените Значение CONTAINER_INHERIT_ACE
Другие контейнеры, которые содержались первичным объектом наследовать АСА.
INHERIT_ONLY_ACE
АС не относится к первичному объекту против которого ACL приложен, но объекты содержимые первичным объектом наследуют АСА.
NO_PROPAGATE_INHERIT_ACE
OBJECT_INHERIT_ACE И флаги CONTAINER_INHERIT_ACE не распространиться унаследованному АСУ.
OBJECT_INHERIT_ACE
Объекты Noncontainer содержимые первичным объектом наследуют АСА.
SUB_CONTAINERS_ONLY_INHERIT
Другие контейнеры, которые содержались первичным объектом наследовать АСА. Этот флаг переписывается на флаг CONTAINER_INHERIT_ACE.
SUB_OBJECTS_ONLY_INHERIT
Объекты Noncontainer содержимые первичным объектом наследуют АСА. Этот флаг переписывается на флаг OBJECT_INHERIT_ACE.
SUB_CONTAINERS_AND_OBJECTS_INHERIT
Как контейнеры так и noncontainer объекты, которые содержались первичным объектом наследуют АСА. Этот флаг переписывается в комбинацию CONTAINER_INHERIT_ACE и флагов OBJECT_INHERIT_ACE.


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

Ничто.

Смотри Также

АС, ACL, EXPLICIT_ACCESS, GetExplicitEntriesFromAcl, SetEntriesInAcl, TRUSTEE


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