Location: Symbol Reference > Classes > TJwServerAccessControl Class > TJwServerAccessControl Methods > TJwServerAccessControl.IsAccessAllowed Method
Collapse All
JWSCL Documentation
ContentsIndexHome
PreviousUpNext
TJwServerAccessControl.IsAccessAllowed Method
TJwServerAccessControl Class  TJwServerAccessControl Members  TJwServerAccessControl Methods  Send Feedback
Pascal
function IsAccessAllowed(pTrustee: PTRUSTEEW; lpProperty: LPWSTR; AccessRights: ACCESS_RIGHTS; var pfAccessAllowed: BOOL): HRESULT; stdcall;
Parameters
Parameters 
Description 
pTrustee: PTRUSTEEW 
A trustee that is used to check access. 
lpProperty: LPWSTR 
Not used. Must be empty. 
AccessRights: ACCESS_RIGHTS 
An bit mask of access rights to be used to do the access right. This is a desired access mask. 
var pfAccessAllowed: BOOL 
A boolean value receiving the access check result. A return value of TRUE means that the trustee was granted access; otherwise the access was denied.
In case of an error this value is set to FALSE. 
Returns

This method can return several, among others, these error codes:

Value 
Description 
S_OK 
Successfully completed. Parameter cbSize contains the size. 
E_INVALIDARG 
  • Parameter pAccessList is nil
  • pAccessList.pPropertyAccessList is nil

This error is not returned in case of StrictACLVerify is true. 
MAKE_HRESULT(1, FacilityCode, ERROR_INVALID_PARAMETER) 
This error is only returned if property StrictACLVerify is true.
  • A Trustee member is invalid. See IsValidTrustee for more information.
 
MAKE_HRESULT(1, FacilityCode, ERROR_INVALID_SID) 
The SID of the trustee structure could not be retrieved. Either it is invalid or it is nil. 
E_UNEXPECTED 
An exception occured that is not an EOleSysError exception. 
others 
There can be other errors coming from a EOleSysError. The value is the same as the value of the member ErrorCode of EOleSysError. 

 

This method behaves differently in a debug or release build. In a debug build an exception is returned to the caller. This can be useful in a debugging session.

Description

The method GrantAccessRights checks whether the given trustee has access or not.

Remarks

This method implements IsAccessAllowed of IAccessControl. 

This method is affected by property StrictACLVerify when set to True. 

In case of StrictACLVerify is true pTrustee must be a user or group SID (without object).

Group
Links
Copyright (c) 2010. All rights reserved.
This help was created by Doc-O-Matic sponsored by toolsfactory software inc.
Contents | Index | Home
What do you think about this topic? Send feedback!