Location: Symbol Reference > Classes > TJwPrivilegeSet Class
JWSCL Documentation
ContentsIndexHome
PreviousUpNext
TJwPrivilegeSet Class
Pascal
TJwPrivilegeSet = class(TObject);

TJwPrivilegeSet is a set of Privileges (defined by TJwPrivilege) There are two types of instances of TJwPrivilegeSet.

  1. TJwPrivilegeSet with an assigned token
  2. TJwPrivilegeSet without an assigned token.
It is not possible to change from one to the other case. 

  1. If the token is assigned, you can enable or disable privileges. However
you cannot change privileges arbitrarily.
  1. If the privleges set is not assigned to a token, you can add or remove privileges arbitrarily.
However you cannot enable or disable privileges. 

The description of these function shows what happens in one of these cases.

 
Name 
Description 
 
This is the overview for the Create constructor overload. 
 
This is Destroy, a member of class TJwPrivilegeSet. 
Name 
Description 
The following tables list the members exposed by TJwPrivilegeSet. 
The methods of the TJwPrivilegeSet class are listed here. 
The properties of the TJwPrivilegeSet class are listed here. 
 
Name 
Description 
 
This is the overview for the AddPrivilege method overload. 
 
This is Clear, a member of class TJwPrivilegeSet. 
 
Create_PLUID_AND_ATTRIBUTES creates an array of luid and attribute structure from the list of added privileges in this instance of TJwPrivilegeSet. The number of array elements is count. If count is zero the return value is nil.
The structure must be freed by Free_PLUID_AND_ATTRIBUTES . If not freed by the user the structure will be freed on destruction of the TJwPrivilegeSet instance. All created structures by Create_PLUID_AND_ATTRIBUTES are freed in this way. 
 
Create_PPRIVILEGE_SET creates a set of privileges with an array of luids and attributes from the list of added privileges in this instance of TJwPrivilegeSet. The number of array elements is count. If count is zero the return value is an emtpy structure but not nil
 
 
Create_PTOKEN_PRIVILEGES creates a set of privileges with an array of luids and attributes from the list of added privileges in this instance of TJwPrivilegeSet. The number of array elements is count. If count is zero the return value is an emtpy structure but not nil
 
 
This is the overview for the DeletePrivilege method overload. 
 
DisableAllPrivileges disables all privileges in this token. This is done in a faster way than iterate through the privilege list. You can undo this by setting Enabled state of a privilege. 
 
Free_PLUID_AND_ATTRIBUTES frees an allocated luid and attribute structure by Create_PLUID_AND_ATTRIBUTES. Postcondition : privs will be nil.
 
 
Free_PPRIVILEGE_SET frees an allocated set of privileges structure by Create_PPRIVILEGE_SET. Postcondition : privs will be nil.
 
 
Free_PTOKEN_PRIVILEGES frees an allocated luid and attribute structure by Create_PLUID_AND_ATTRIBUTES. Postcondition : privs will be nil.
 
 
GetText creates a string that contains all privileges in a human readable form :  
 
RemoveIrrepealable removes a privilege from the token. It cannot be readded.  
 
Name 
Description 
 
Control is only used if the privilege was created by Create with parameter (aPRIVILEGE_SET : PRIVILEGE_SET). Specifies a control flag related to the privileges. The PRIVILEGE_SET_ALL_NECESSARY control flag is currently defined. It indicates that all of the specified privileges must be held by the process requesting access. If this flag is not set, the presence of any privileges in the user's access token grants the access.
http://msdn2.microsoft.com/en-us/library/aa379307.aspx 
 
Count contains the count of privileges 
 
The owner token of this privilege set. If the privilege set belongs to a token, Owner is not nil. In this case the privilege in the list are assigned to a token. 
 
PrivByIdx[Index returns a privilege by its index of list Be aware that an index can change if the set is updated. If the index is not between 0 and Count-1 the Exception EJwsclInvalidIndexPrivilegeException is raised. 
 
PrivByLUID[Index returns a privilege by its LUID (locally unique ID) If the given privilege was not found the result is nil. 
 
PrivByName[Index returns a privilege by its name. The string is compared case sensitive! You can use system constants from JwaWinNT (like SE_CREATE_TOKEN_NAME). If the given privilege was not found the result 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!