AtlGetSecurityDescriptor
Эта функция вызывается для получения дескриптора безопасности для данного объекта.
Важно!
Эту функцию нельзя использовать в приложениях, выполняемых в Среда выполнения Windows.
inline bool AtlGetSecurityDescriptor(
LPCTSTR pszObjectName,
SE_OBJECT_TYPE ObjectType,
CSecurityDesc * pSecurityDescriptor,
SECURITY_INFORMATION requestedInfo= OWNER_SECURITY_INFORMATION |
GROUP_SECURITY_INFORMATION | DACL_SECURITY_INFORMATION |
SACL_SECURITY_INFORMATION,
bool bRequestNeededPrivileges= true
) throw(...);
Параметры
pszObjectName
Указатель на null- завершенной строку, которая задает имя объекта, из которого извлекаются сведения о безопасности.ObjectType
Задает значение из перечисления SE_OBJECT_TYPE, которое указывает тип объекта, заданный параметром pszObjectName .pSecurityDescriptor
Объект, получающий дескриптор безопасности.requestedInfo
Набор флагов, указывающих тип bit SECURITY_INFORMATION сведения о безопасности для получения. Этот параметр может быть сочетанием следующих значений.bRequestNeededPrivileges
True, если функция будет пытаться включить права SE_SECURITY_NAME, и извлекает его при завершении.
Возвращаемое значение
Возвращает значение true, если операция выполнена успешно; в противном случае — значение false.
Заметки
Если AtlGetSecurityDescriptor вызываться несколько раз во многих различных объектов, оно будет более эффективным включение привилегию SE_SECURITY_NAME один раз до вызова функции с bRequestNeededPrivileges установлено в значение false.
Требования
Header: atlsecurity.h