На главную

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

AccessCheckAndAuditAlarm



The AccessCheckAndAuditAlarm function performs an access validation and generates corresponding audit messages. An application can also use this function to determine whether necessary privileges are held by a client process. This function is generally used by a server application impersonating a client process. Alarms are not supported in the current version of Windows NT.

BOOL AccessCheckAndAuditAlarm(

LPCTSTR SubsystemName, // address of string for subsystem name
LPVOID HandleId, // address of handle identifier
LPTSTR ObjectTypeName, // address of string for object type
LPTSTR ObjectName, // address of string for object name
PSECURITY_DESCRIPTOR SecurityDescriptor, // address of security descriptor
DWORD DesiredAccess, // mask for requested access rights
PGENERIC_MAPPING GenericMapping, // address of GENERIC_MAPPING
BOOL ObjectCreation, // object-creation flag
LPDWORD GrantedAccess, // address of mask for granted rights
LPBOOL AccessStatus, // address of flag for results
LPBOOL pfGenerateOnClose // pointer to flag for audit generation
);


Parameters

SubsystemName

Pointer to a null-terminated string specifying the name of the subsystem calling the function ѕ for example, "DEBUG" or "WIN32."

HandleId

Points to a unique 32-bit value representing the client's handle to the object. If the access is denied, this value is ignored and may be reused.

ObjectTypeName

Points to a null-terminated string specifying the type of object being created or accessed. This string appears in the audit log for the object.

ObjectName

Points to a null-terminated string specifying the name of the object being created or accessed. This string appears in the audit log for the object.

SecurityDescriptor

Points to the SECURITY_DESCRIPTOR structure against which access is checked.

DesiredAccess

Specifies an access mask giving the requested access rights. This mask must have been mapped to contain no generic access rights by the MapGenericMask function.

GenericMapping

Points to the GENERIC_MAPPING structure associated with the type of object being examined.

ObjectCreation

Specifies a flag that determines whether the calling application will create a new object when access is granted. If this flag is TRUE, the application creates a new object; if it is FALSE, the application opens an existing object.

GrantedAccess

Points to a buffer that receives an access mask indicating which access rights were granted, if the function succeeds.

AccessStatus

Points to a flag that the function sets to indicate the success or failure of the access check. If access is granted, this flag is TRUE; otherwise, it is FALSE.

pfGenerateOnClose

Pointer to a flag set by the audit-generation routine when the function returns. This flag must be passed to the ObjectCloseAuditAlarm function when the object handle is closed.



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 AccessCheckAndAuditAlarm function compares the specified security descriptor with the impersonation access token of the calling process and indicates whether access is granted or denied. If access is granted, the requested access mask becomes the granted access mask for the object. This function also generates any necessary audit messages as a result of the access attempt.
This function requires the calling process to have the SE_AUDIT_NAME privilege. The test for this privilege is performed against the primary token of the calling process, not the impersonation token of the thread.

See Also

AccessCheck, AreAllAccessesGranted, AreAnyAccessesGranted, GENERIC_MAPPING, MapGenericMask, ObjectCloseAuditAlarm, ObjectOpenAuditAlarm, ObjectPrivilegeAuditAlarm, PrivilegeCheck, PrivilegedServiceAuditAlarm, SECURITY_DESCRIPTOR


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

AccessCheckAndAuditAlarm



Функция AccessCheckAndAuditAlarm выполняет подтверждение доступа и генерирует сообщения проверки соответствовать. Приложение может также использовать эту функцию, чтобы определять что независимо необходимые привилегии подержаны процессом клиента. Эта функция обычно использована приложением сервера, подражающим процессу клиента. Тревоги не поддерживаны в текущей версии Windows NT.

BOOL AccessCheckAndAuditAlarm(

LPCTSTR SubsystemName, // АДРЕС строки для имени подсистемы LPVOID HandleId, // адрес идентификатора ручки LPTSTR ObjectTypeName, // адрес строки для объектного типа LPTSTR ObjectName, // адрес строки для объектного имени PSECURITY_DESCRIPTOR SecurityDescriptor, // адрес дескриптора безопасности DWORD DesiredAccess, // маска для запрошенных прав доступа PGENERIC_MAPPING GenericMapping, // адрес GENERIC_MAPPING BOOL ObjectCreation, // объектное создание флага LPDWORD GrantedAccess, // адрес без доказательств прав маски LPBOOL AccessStatus, // адрес флага для результатов LPBOOL pfGenerateOnClose // указатель, чтобы сигнализировать для поколения проверки
);


Параметры

SubsystemName

Указатель в недействительный расторгнутую строку, определяющую имя разговора подсистемы функция U например, "ОТЛАДКА" или "WIN32."

HandleId

Точки на уникальную 32- битовую величину, представляющие ручку клиента на объект. Если доступ запрещен, эта величина проигнорирована и может быть использована многократно.

ObjectTypeName

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

ObjectName

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

SecurityDescriptor

Точки на структуру SECURITY_DESCRIPTOR против которых доступ проверен.

DesiredAccess

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

GenericMapping

Точки на структуру GENERIC_MAPPING связывались типом объекта, изучанного.

ObjectCreation

Определяет флаг, который определяет создаст вызывающее приложение новый объект когда доступу предоставляют. Если этот флаг является ИСТИНОЙ, приложение создает новый объект; если это - ЛОЖЬ, приложение открывает существующий объект.

GrantedAccess

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

AccessStatus

Точки на флаг, что функция устанавливает, чтобы указывать успех или неудачу чека доступа. Если доступу предоставляют, этот флаг является ИСТИНОЙ; в противном случае, это ЛОЖНОЕ.

pfGenerateOnClose

Указатель на флаг был установлен проверкой-поколением программы когда функция возвращается. Этот флаг должен быть пройден в функцию ObjectCloseAuditAlarm когда объектная ручка закрыта.



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

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

Замечания

Функция AccessCheckAndAuditAlarm сравнивает определенный дескриптор безопасности с признаком доступа маскировки разговора обрабатывать и указывает что независимо доступу предоставляют или запрещен. Если доступу предоставляют, запрошенная маска доступа становится предоставлянной маской доступа для объекта. Эта функция также генерирует любые необходимые сообщения проверки в результате попытки доступа.
Эта функция требует разговор процесса, чтобы иметь привилегию SE_AUDIT_NAME. Тест для этой привилегии выполнен против первичного признака разговора процесса, не признак маскировки резьбы.

Смотри Также

AccessCheck, AreAllAccessesGranted, AreAnyAccessesGranted, GENERIC_MAPPING, MapGenericMask, ObjectCloseAuditAlarm, ObjectOpenAuditAlarm, ObjectPrivilegeAuditAlarm, PrivilegeCheck, PrivilegedServiceAuditAlarm, SECURITY_DESCRIPTOR


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