Location: Symbol Reference > Classes > TJwAuthContext Class > TJwAuthContext Methods > TJwAuthContext.AccessCheckCached Method
|
JWSCL Documentation
|
   |
   |
TJwAuthContext.AccessCheckCached Method
|
JWSCL Documentation
|
|
|
procedure AccessCheckCached(const AccessCheckHandle: TAuthZAccessCheckResultHandle; Flags: Cardinal; const Request: TJwAuthZAccessRequest; const AuditInfo: TAuthZAuditInfoHandle; out Reply: TJwAuthZAccessReply);
|
Parameters |
Description |
|
const AccessCheckHandle: TAuthZAccessCheckResultHandle |
receives an handle that was previously retrieved by a call to AccessCheck. The handle must be freed by the WinAPI call AuthzFreeHandle . |
|
Flags: Cardinal |
from http://msdn2.microsoft.com/en-us/library/aa375788.aspx A DWORD value that specifies how the security descriptor is copied. This parameter can be one of the following values.
The AccessCheck function sets this handle to a security descriptor that must remain valid during subsequent calls to AccessCheckCached. |
|
const Request: TJwAuthZAccessRequest |
receives a class that contains information about the access check procedure. This instance is automatically freed if no exception was raised and Request.Shared is shOwned. |
|
const AuditInfo: TAuthZAuditInfoHandle |
Receives audit information handle. If this handle is zero the static audit information is read from resource manager |
|
out Reply: TJwAuthZAccessReply |
receives the results of the access check |
AccessCheckCached does a cached access check of an authentication context. The context contains Sids, restricted sids, several security descriptors, auditing information and the user herself.
A cached access check is really a bit comparison of the desired access with the granted access. Thus this function is only useful if access checks are done several times using the same user (SID), e.g. a repeating access check using different desired access masks for different function calls. An access check for different users must be done by using method AccessCheck.
|
Exceptions |
Description |
|
if a call to AuthzAccessCheck failed. | |
|
will be raised if parameter Request, SecurityDescriptor or Request.PrincipalSelfSid is nil |
|
Copyright (c) 2010. All rights reserved.
This help was created by Doc-O-Matic sponsored by toolsfactory software inc. |
|
What do you think about this topic? Send feedback!
|