На главную

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

MakeAbsoluteSD



The MakeAbsoluteSD function creates a security descriptor in absolute format by using a security descriptor in self-relative format as a template.

BOOL MakeAbsoluteSD(

PSECURITY_DESCRIPTOR pSelfRelativeSecurityDescriptor, // address self-relative SD
PSECURITY_DESCRIPTOR pAbsoluteSecurityDescriptor, // address of absolute SD
LPDWORD lpdwAbsoluteSecurityDescriptorSize, // address of size of absolute SD
PACL pDacl, // address of discretionary ACL
LPDWORD lpdwDaclSize, // address of size of discretionary ACL
PACL pSacl, // address of system ACL
LPDWORD lpdwSaclSize, // address of size of system ACL
PSID pOwner, // address of owner SID
LPDWORD lpdwOwnerSize, // address of size of owner SID
PSID pPrimaryGroup, // address of primary-group SID
LPDWORD lpdwPrimaryGroupSize // address of size of group SID
);


Parameters

pSelfRelativeSecurityDescriptor

Points to a SECURITY_DESCRIPTOR structure in self-relative format. The function creates an absolute-format version of this security descriptor without modifying the original security descriptor.

pAbsoluteSecurityDescriptor

Points to a buffer that the function fills with the main body of an absolute-format security descriptor. This information is formatted as a SECURITY_DESCRIPTOR structure.

lpdwAbsoluteSecurityDescriptorSize

Points to a variable specifying the size of the buffer pointed to by the pAbsoluteSecurityDescriptor parameter. If the buffer is not large enough for the security descriptor, the function fails and sets this variable to the minimum required size.

pDacl

Points to a buffer the function fills with the discretionary access-control list (ACL) of the absolute-format security descriptor. The main body of the absolute-format security descriptor references this pointer.

lpdwDaclSize

Points to a variable specifying the size of the buffer pointed to by the pDacl parameter. If the buffer is not large enough for the ACL, the function fails and sets this variable to the minimum required size.

pSacl

Points to a buffer the function fills with the system ACL of the absolute-format security descriptor. The main body of the absolute-format security descriptor references this pointer.

lpdwSaclSize

Points to a variable specifying the size of the buffer pointed to by the pSacl parameter. If the buffer is not large enough for the ACL, the function fails and sets this variable to the minimum required size.

pOwner

Points to a buffer the function fills with the security identifier (SID) of the owner of the absolute-format security descriptor. The main body of the absolute-format security descriptor references this pointer.

lpdwOwnerSize

Points to a variable specifying the size of the buffer pointed to by the pOwner parameter. If the buffer is not large enough for the SID, the function fails and sets this variable to the minimum required size.

pPrimaryGroup

Points to a buffer the function fills with the SID of the absolute-format security descriptor's primary group. The main body of the absolute-format security descriptor references this pointer.

lpdwPrimaryGroupSize

Points to a variable specifying the size of the buffer pointed to by the pPrimaryGroup parameter. If the buffer is not large enough for the SID, the function fails and sets this variable to the minimum required size.



Return Values

If the function succeeds, the return value is nonzero.
If the function fails, the return value is zero. To get extended error information, call GetLastError.

Remarks

A security descriptor in absolute format contains pointers to the information it contains, rather than the information itself. A security descriptor in self-relative format contains the information in a contiguous block of memory. In a self-relative security descriptor, a SECURITY_DESCRIPTOR structure always starts the information, but the security descriptor's other components can follow the structure in any order. Instead of using memory addresses, the components of the self-relative security descriptor are identified by offsets from the beginning of the security descriptor. This format is useful when an security descriptor must be stored on a floppy disk or transmitted by means of a communications protocol.

A server that copies secured objects to various media can use the MakeAbsoluteSD function to create an absolute security descriptor from a self-relative security descriptor and the MakeSelfRelativeSD function to create a self-relative security descriptor from an absolute security descriptor.

See Also

MakeSelfRelativeSD, SECURITY_DESCRIPTOR


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

MakeAbsoluteSD



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

BOOL MakeAbsoluteSD(

pSelfRelativeSecurityDescriptor PSECURITY_DESCRIPTOR, // адресует относительный pAbsoluteSecurityDescriptor SD PSECURITY_DESCRIPTOR, // адрес абсолютного SD LPDWORD lpdwAbsoluteSecurityDescriptorSize, // адреса размера абсолютного SD PACL pDacl, // адреса дискреционного ACL LPDWORD lpdwDaclSize, // адреса размера дискреционного ACL PACL pSacl, // адреса системы ACL LPDWORD lpdwSaclSize, // адреса размера системы ACL PSID pOwner, // адреса владельца SID LPDWORD lpdwOwnerSize, // адреса размера владельца SID PSID pPrimaryGroup, // адреса первичного-адреса группы SID LPDWORD lpdwPrimaryGroupSize // размера группы SID
);


Параметры

pSelfRelativeSecurityDescriptor

Точки на структуру SECURITY_DESCRIPTOR в относительном формате. Функция создает абсолютный формат версии этого дескриптора безопасности не модифицируя оригинальный дескриптор безопасности.

pAbsoluteSecurityDescriptor

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

lpdwAbsoluteSecurityDescriptorSize

Точки на переменную, определяющие, что размер буфера указывал, чтобы параметром pAbsoluteSecurityDescriptor. Если буфер - не большой достаточно для дескриптора безопасности, функция терпит неудачу и устанавливает эту переменную на минимум требовавшийся размер.

pDacl

Точки на буфер функциональные наполнители дискреционным имеют доступ к-управляющему списку (ACL) дескриптора абсолютного формата безопасности. Основное тело дескриптора абсолютного формата безопасности ссшлется на этот указатель.

lpdwDaclSize

Точки на переменную, определяющие, что размер буфера указывал, чтобы параметром pDacl. Если буфер - не большой достаточно для ACL, функция терпит неудачу и устанавливает эту переменную на минимум требовавшийся размер.

pSacl

Точки на буфер функциональные наполнители системой ACL дескриптора абсолютного формата безопасности. Основное тело дескриптора абсолютного формата безопасности ссшлется на этот указатель.

lpdwSaclSize

Точки на переменную, определяющие, что размер буфера указывал, чтобы параметром pSacl. Если буфер - не большой достаточно для ACL, функция терпит неудачу и устанавливает эту переменную на минимум требовавшийся размер.

pOwner

Точки на буфер функциональные наполнители идентификатором безопасности (SID) владельца дескриптора абсолютного формата безопасности. Основное тело дескриптора абсолютного формата безопасности ссшлется на этот указатель.

lpdwOwnerSize

Точки на переменную, определяющие, что размер буфера указывал, чтобы параметром pOwner. Если буфер - не большой достаточно для SID, функция терпит неудачу и устанавливает эту переменную на минимум требовавшийся размер.

pPrimaryGroup

Точки на буфер функциональные наполнители SID дескриптора абсолютного формата безопасности первичной группы. Основное тело дескриптора абсолютного формата безопасности ссшлется на этот указатель.

lpdwPrimaryGroupSize

Точки на переменную, определяющие, что размер буфера указывал, чтобы параметром pPrimaryGroup. Если буфер - не большой достаточно для SID, функция терпит неудачу и устанавливает эту переменную на минимум требовавшийся размер.



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

Если функция добивается успеха, обратная величина ненулевая.
Если функция терпит неудачу, обратная величина нулевая. Для того, чтобы расширять информацию ошибки, назовите GetLastError.

Замечания

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

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

Смотри Также

MakeSelfRelativeSD, SECURITY_DESCRIPTOR


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