|
| БЕСПЛАТНАЯ ежедневная online лотерея! Выигрывай каждый день БЕСПЛАТНО! |
|
|
GetNamedSecurityInfo
[New - Windows NT]
The GetNamedSecurityInfo function retrieves a copy of the security descriptor for an object specified by name.
DWORD GetNamedSecurityInfo(
LPTSTR pObjectName, // name of the object SE_OBJECT_TYPE ObjectType, // type of object SECURITY_INFORMATION SecurityInfo, // type of security information to retrieve PSID *ppsidOwner, // receives a pointer to the owner SID PSID *ppsidGroup, // receives a pointer to the primary group SID PACL *ppDacl, // receives a pointer to the DACL PACL *ppSacl, // receives a pointer to the SACL PSECURITY_DESCRIPTOR *ppSecurityDescriptor // receives a pointer to the security descriptor );
Parameters
pObjectName
Pointer to a null-terminated string that specifies the name of the object from which to retrieve security information. 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 retrieve. This parameter can be a combination of the following values.
Value Meaning OWNER_SECURITY_INFORMATION If this flag is set, the ppsidOwner parameter receives the security identifier (SID) of the object's owner. GROUP_SECURITY_INFORMATION If this flag is set, the ppsidGroup parameter receives the SID of the object's primary group. DACL_SECURITY_INFORMATION If this flag is set, the ppDacl parameter receives the object's discretionary access-control list (DACL). SACL_SECURITY_INFORMATION If this flag is set, the ppSacl parameter receives the object's system access-control list (SACL)..
ppsidOwner
Pointer to a variable that receives a pointer to the owner SID in the security descriptor returned in ppSecurityDescriptor. The returned pointer is valid only if you set the OWNER_SECURITY_INFORMATION flag. This parameter can be NULL if you do not need the owner SID.
ppsidGroup
Pointer to a variable that receives a pointer to the primary group SID in the returned security descriptor. The returned pointer is valid only if you set the GROUP_SECURITY_INFORMATION flag. This parameter can be NULL if you do not need the group SID.
ppDacl
Pointer to a variable that receives a pointer to the DACL in the returned security descriptor. The returned pointer is valid only if you set the DACL_SECURITY_INFORMATION flag. This parameter can be NULL if you do not need the DACL.
ppSacl
Pointer to a variable that receives a pointer to the SACL in the returned security descriptor. The returned pointer is valid only if you set the SACL_SECURITY_INFORMATION flag. This parameter can be NULL if you do not need the SACL.
ppSecurityDescriptor
Pointer to a variable that receives a pointer to the security descriptor of the object. You must call the LocalFree function to free the returned buffer.
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.
Remarks
If the ppsidOwner, ppsidGroup, ppDacl, ppSacl parameters are non-NULL, and the SecurityInfo parameter specifies that they be retrieved from the object, those parameters will point to the corresponding parameters in the security descriptor returned in ppSecurityDescriptor. To read the object's owner, group and DACL the caller must have READ_CONTROL access or be the owner of the object. The caller must have the SE_SECURITY_NAME privilege enabled to read the SACL.
See Also
ACL, GetSecurityInfo, LocalFree, SE_OBJECT_TYPE, SECURITY_DESCRIPTOR, SECURITY_INFORMATION, SetNamedSecurityInfo, SetSecurityInfo, SID
| Пригласи друзей и счет твоего мобильника всегда будет положительным! |
| Пригласи друзей и счет твоего мобильника всегда будет положительным! |
GetNamedSecurityInfo
[Новый - Windows NT]
Функция GetNamedSecurityInfo извлекает копию дескриптора безопасности для объекта определенного по имени.
DWORD GetNamedSecurityInfo(
LPTSTR pObjectName, // ИМЯ объекта SE_OBJECT_TYPE ObjectType, // типа объекта SECURITY_INFORMATION SecurityInfo, // типа информации безопасности, чтобы извлекать PSID *ppsidOwner, // получает указатель владельцу SID PSID *ppsidGroup, // приемники указатель в первичную группу SID PACL *ppDacl, // приемники указатель на DACL PACL *ppSacl, // приемники указатель на SACL PSECURITY_DESCRIPTOR *ppSecurityDescriptor // получает указатель в дескриптор безопасности );
Параметры
pObjectName
Указатель в недействительный расторгнутую строку, которая определяет имя объекта из которого, чтобы извлекать информацию безопасности. Для описаний форматов строки для других объектных типов, смотри SE_OBJECT_TYPE.
ObjectType
Определяет величину из перечисления SE_OBJECT_TYPE, которое указывает тип объекта назывался параметром pObjectName.
SecurityInfo
Установка бита SECURITY_INFORMATION сигнализирует, что указывает тип информации безопасности, чтобы извлекаться. Этот параметр может быть комбинацией следующего величин.
Значение Величины OWNER_SECURITY_INFORMATION Если этот флаг установлен, параметр ppsidOwner получает идентификатор безопасности (SID) объектного владельца. GROUP_SECURITY_INFORMATION Если этот флаг установлен, параметр ppsidGroup получает SID объектный первичный группа. DACL_SECURITY_INFORMATION Если этот флаг установлен, параметр ppDacl получает объектный дискреционный иметь доступ к-управляющему списку (DACL). SACL_SECURITY_INFORMATION Если этот флаг установлен, параметр ppSacl получает объектный системный иметь доступ к-управляющему списку (SACL)..
ppsidOwner
Указатель в переменную, которая получает указатель владельцу SID в дескрипторе безопасности возвращанном в ppSecurityDescriptor. Возвращанный указатель - в силе только если Вы установили бы флаг OWNER_SECURITY_INFORMATION. Этот параметр может быть НЕДЕЙСТВИТЕЛЕН если Вам не нужно владелец SID.
ppsidGroup
Указатель в переменную, которая получает указатель в первичную группу SID в возвращанном дескрипторе безопасности. Возвращанный указатель - в силе только если Вы установили бы флаг GROUP_SECURITY_INFORMATION. Этот параметр может быть НЕДЕЙСТВИТЕЛЕН если Вам не нужно группа SID.
ppDacl
Указатель в переменную, которая получает указатель на DACL в возвращанном дескрипторе безопасности. Возвращанный указатель - в силе только если Вы установили бы флаг DACL_SECURITY_INFORMATION. Этот параметр может быть НЕДЕЙСТВИТЕЛЕН если Вам не нужно DACL.
ppSacl
Указатель в переменную, которая получает указатель на SACL в возвращанном дескрипторе безопасности. Возвращанный указатель - в силе только если Вы установили бы флаг SACL_SECURITY_INFORMATION. Этот параметр может быть НЕДЕЙСТВИТЕЛЕН если Вам не нужно SACL.
ppSecurityDescriptor
Указатель в переменную, которая получает указатель в дескриптор безопасности объекта. Вы должны назвать функцию LocalFree, чтобы освобождать возвращанный буфер.
Обратные Величины
Если функция добивается успеха, обратная величина - ERROR_SUCCESS. Если функция терпит неудачу, обратная величина является ненулевым кодом ошибки определенным в WINERROR.H.
Замечания
Если ppsidOwner, ppsidGroup, ppDacl, параметры ppSacl не-НЕДЕЙСТВИТЕЛЬНЫ, и параметр SecurityInfo определяет, что они извлечены с объекта, те параметры укажет на соответствующие параметры в дескрипторе безопасности возвращанном в ppSecurityDescriptor. Для того, чтобы читать объектного владельца, сгруппируйте и DACL вызывающий оператор должен иметь доступ READ_CONTROL или быть владельцем объекта. Вызывающий оператор должен позволить привилегию SE_SECURITY_NAME, чтобы читать SACL.
Смотри Также
ACL, GetSecurityInfo, LocalFree, SE_OBJECT_TYPE, SECURITY_DESCRIPTOR, SECURITY_INFORMATION, SetNamedSecurityInfo, SetSecurityInfo, SID
|
|
|
|
| |