Location: Symbol Reference > Classes > TJwServerAccessControl Class > TJwServerAccessControl Methods > TJwServerAccessControl.RevokeAccessRights Method
Collapse All
JWSCL Documentation
ContentsIndexHome
PreviousUpNext
TJwServerAccessControl.RevokeAccessRights Method
TJwServerAccessControl Class  TJwServerAccessControl Members  TJwServerAccessControl Methods  Send Feedback
Pascal
function RevokeAccessRights(lpProperty: LPWSTR; cTrustees: ULONG; prgTrustees: PTRUSTEEW): HRESULT; stdcall;
Parameters
Parameters 
Description 
lpProperty: LPWSTR 
Currently not used. Must be empty. 
cTrustees: ULONG 
Number of trustees in structure prgTrustees. 
prgTrustees: PTRUSTEEW 
Receives an array of TRUSTEEW members. 
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

RevokeAccessRights removes all given access entries from the DACL.

Remarks

All supplied SIDs are removed from the DACL. If a single SID is used several times in the DACL all occurences are removed. 

The function is called by the interface method with the same name. Since the interface method returns a HRESULT value this version must raise an EOleSysError and supply the return value to EOleSysError constructor (ErrorCode). Use

Copy Code
  raise EOleSysError.Create('text message', MAKE_HRESULT(1, FacilityCode, Win32_or_User_Code));

 

This method implements RevokeAccessRights of IAccessControl. 

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

In case of StrictACLVerify is true parameter prgTrustees 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!