На главную

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

PrivilegeCheck



The PrivilegeCheck function tests the security context represented by a specific access token to discover whether it contains the specified privileges. This function is typically called by a server application to check the privileges of a client's access token.

BOOL PrivilegeCheck(

HANDLE ClientToken, // handle of client's access token
PPRIVILEGE_SET RequiredPrivileges, // address of privileges
LPBOOL pfResult // address of flag for result
);


Parameters

ClientToken

Identifies an access token representing a client process. This handle must have been obtained by opening the token of a thread impersonating the client. The token must be open for TOKEN_QUERY access.

RequiredPrivileges

Points to a PRIVILEGE_SET structure specifying the privileges required.

The specified access token is checked to see which of the specified privileges are present. When a privilege specified in the PRIVILEGE_SET structure is found in the access token, the function sets the SE_PRIVILEGE_USED_FOR_ACCESS attribute for that privilege in the corresponding LUID_AND_ATTRIBUTES structure.

pfResult

Points to a flag the function sets to indicate whether the access token contains any or all of the specified privileges. If PRIVILEGE_SET_ALL_NECESSARY is specified in the Control member of the PRIVILEGE_SET structure pointed to by the RequiredPrivileges parameter, this flag is TRUE only if all requested privileges are present in the access token. If PRIVILEGE_SET_ALL_NECESSARY is not specified, and if any of the privileges are present, this flag is TRUE.



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.

See Also

AccessCheck, AccessCheckAndAuditAlarm, AreAllAccessesGranted, AreAnyAccessesGranted, LookupPrivilegeDisplayName, LookupPrivilegeName
, LookupPrivilegeValue, LUID_AND_ATTRIBUTES, ObjectPrivilegeAuditAlarm, PRIVILEGE_SET, PrivilegedServiceAuditAlarm


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

PrivilegeCheck



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

BOOL PrivilegeCheck(

РУЧКА ClientToken, // ручка признака доступа клиента PPRIVILEGE_SET RequiredPrivileges, // адреса адреса привилегий LPBOOL pfResult // флага для результата
);


Параметры

ClientToken

Идентифицирует признак доступа представляя процесс клиента. Эта ручка по-видимому получена открытием признака резьбы, подражающей клиенту. Признак должен быть открытым для доступа TOKEN_QUERY.

RequiredPrivileges

Точки на структуру PRIVILEGE_SET, определяющие, что привилегии требовали.

Определенный признак доступа проверен которая из определенных привилегий присутствуют. Когда привилегия определенная в структуре PRIVILEGE_SET обнаружена в признаке доступа, функция устанавливает атрибут SE_PRIVILEGE_USED_FOR_ACCESS для этой привилегии в соответствующей структуре LUID_AND_ATTRIBUTES.

pfResult

Точки на флаг функциональные комплекты, чтобы указывать содержит признак доступа любое или все определившее привилегии. Если PRIVILEGE_SET_ALL_NECESSARY определен в элементе Управления структуры PRIVILEGE_SET указанной, чтобы параметром RequiredPrivileges, этот флаг является ИСТИНОЙ только если все запрошенные привилегии присутствуют в признаке доступа. Если PRIVILEGE_SET_ALL_NECESSARY не определен, и если любая из привилегий присутствуют, этот флаг является ИСТИНОЙ.



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

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

Смотри Также

AccessCheck, AccessCheckAndAuditAlarm, AreAllAccessesGranted, AreAnyAccessesGranted, LookupPrivilegeDisplayName, LookupPrivilegeName , LookupPrivilegeValue, LUID_AND_ATTRIBUTES, ObjectPrivilegeAuditAlarm, PRIVILEGE_SET, PrivilegedServiceAuditAlarm


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