На главную

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

MakeSelfRelativeSD



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

BOOL MakeSelfRelativeSD(

PSECURITY_DESCRIPTOR pAbsoluteSecurityDescriptor, // address of absolute SD
PSECURITY_DESCRIPTOR pSelfRelativeSecurityDescriptor, // address self-relative SD
LPDWORD lpdwBufferLength // address of SD size
);


Parameters

pAbsoluteSecurityDescriptor

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

pSelfRelativeSecurityDescriptor

Points to a buffer the function fills with a security descriptor in self-relative format.

lpdwBufferLength

Points to a variable specifying the size of the buffer pointed to by the pSelfRelativeSecurityDescriptor parameter. If the buffer is not large enough for the security descriptor, 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 containing 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 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 MakeSelfRelativeSD function to create a self-relative security descriptor from an absolute security descriptor and the MakeAbsoluteSD function to create an absolute security descriptor from a self-relative security descriptor.

See Also

MakeAbsoluteSD, SECURITY_DESCRIPTOR


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

MakeSelfRelativeSD



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

BOOL MakeSelfRelativeSD(

pAbsoluteSecurityDescriptor PSECURITY_DESCRIPTOR, // адрес абсолютного pSelfRelativeSecurityDescriptor SD PSECURITY_DESCRIPTOR, // адресуют относительный адрес SD LPDWORD lpdwBufferLength // размера SD
);


Параметры

pAbsoluteSecurityDescriptor

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

pSelfRelativeSecurityDescriptor

Точки на буфер функциональные наполнители дескриптором безопасности в относительном формате.

lpdwBufferLength

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



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

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

Замечания

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

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

Смотри Также

MakeAbsoluteSD, SECURITY_DESCRIPTOR


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