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 | Скачать

SetPrivateObjectSecurity

The SetPrivateObjectSecurity function modifies a private object's security descriptor.

BOOL SetPrivateObjectSecurity(

SECURITY_INFORMATION SecurityInformation, // type of security information
PSECURITY_DESCRIPTOR ModificationDescriptor, // address of SD to apply to object
PSECURITY_DESCRIPTOR *ObjectsSecurityDescriptor, // address of object's SD
PGENERIC_MAPPING GenericMapping, // address of access-mapping structure
HANDLE Token // handle of client access token
);

Parameters

SecurityInformation

Specifies a SECURITY_INFORMATION structure identifying the contents of the security descriptor pointed to by the ModificationDescriptor parameter.

ModificationDescriptor

Points to a SECURITY_DESCRIPTOR structure to be applied to the object.

ObjectsSecurityDescriptor

Points to a pointer to a SECURITY_DESCRIPTOR structure to be altered by this function. This security descriptor must be in self-relative form.

GenericMapping

Points to a GENERIC_MAPPING structure specifying the mapping of generic to specific and standard access types for the object.

Token

Identifies the access token for the client on whose behalf the private object's security is being modified. This parameter is required to ensure that the client has provided a legitimate value for a new owner security identifier (SID). The token must be open for TOKEN_QUERY access.

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

The object's security descriptor must be in self-relative form.
If necessary, the SetPrivateObjectSecurity function allocates additional memory to produce a larger security descriptor.
The SetPrivateObjectSecurity function is successful only if the following conditions are met:

· If the object's owner is being set, the calling process must have either WRITE_OWNER permission or be the object's owner.
· If the object's discretionary access-control list (ACL) is being set, the calling process must have either WRITE_DAC permission or be the object's owner.
· If the object's system ACL is being set, the SE_SECURITY_NAME privilege must be enabled for the calling process.

The process calling this function must not be impersonating a client.

See Also

CreatePrivateObjectSecurity, DestroyPrivateObjectSecurity, GENERIC_MAPPING, GetPrivateObjectSecurity, SECURITY_DESCRIPTOR, SECURITY_INFORMATION, SetFileSecurity, SetKernelObjectSecurity, SetUserObjectSecurity

Пригласи друзей и счет твоего мобильника всегда будет положительным!

Пригласи друзей и счет твоего мобильника всегда будет положительным!

SetPrivateObjectSecurity

Функция SetPrivateObjectSecurity модифицирует частный объектный дескриптор безопасности.

BOOL SetPrivateObjectSecurity(

SECURITY_INFORMATION SecurityInformation, // тип информации безопасности PSECURITY_DESCRIPTOR ModificationDescriptor, // адреса SD, которые относятся, чтобы возражать PSECURITY_DESCRIPTOR *ObjectsSecurityDescriptor, // адрес объектного SD PGENERIC_MAPPING GenericMapping, // адреса доступа-распределения структурной РУЧКИ Признака // ручка признака доступа клиента
);

Параметры

SecurityInformation

Определяет структуру SECURITY_INFORMATION опознавая содержание дескриптора безопасности указывался, чтобы параметром ModificationDescriptor.

ModificationDescriptor

Точки на структуру SECURITY_DESCRIPTOR, которые нужно прилагать к объекту.

ObjectsSecurityDescriptor

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

GenericMapping

Точки на структуру GENERIC_MAPPING, определяющие распределение общее в специфический и стандартный доступ набирается для объекта.

Признак

Идентифицирует признак доступа для клиента от чьего имени частная объектная безопасность модифицируется. Требуется, чтобы Этот параметр проверил, что клиент предусмотрел законную величину для идентификатора безопасности нового владельца (SID). Признак должен быть открытым для доступа TOKEN_QUERY.

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

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

Замечания

Объектный дескриптор безопасности должен быть в относительной форме.
Если необходимо, функция SetPrivateObjectSecurity распределяет дополнительную память, чтобы производить больший дескриптор безопасности.
Функция SetPrivateObjectSecurity имеет успех только если следующие условия выполнены:

Если объектный владелец установленн, вызов процесса должен иметь или разрешение WRITE_OWNER или будет объектный владелец.
Если объектный дискреционный иметь доступ к-управляющему списку (ACL), установленн, вызов процесса должен иметь или разрешение WRITE_DAC или будет объектный владелец.
Если объектная система ACL установленн, привилегия SE_SECURITY_NAME должна быть приспособлена для вызова процесса.

Процесс, вызывающий эту функцию не должно подражать клиенту.

Смотри Также

CreatePrivateObjectSecurity, DestroyPrivateObjectSecurity, GENERIC_MAPPING, GetPrivateObjectSecurity, SECURITY_DESCRIPTOR, SECURITY_INFORMATION, SetFileSecurity, SetKernelObjectSecurity, SetUserObjectSecurity

Используются технологии uCoz