ConfigurationManager.Roles

[This documentation is preliminary and is subject to change.]

The Roles property retrieves a value that identifies the role.

Property Roles

Property Value

This property is read-only. The property returns an bitwise-combination of the following values.

Value Description
None (0x0) No role is defined.
Auditor (0x1) The auditing role is defined.
TemplateEditor (0x2) The rights template editing role is defined.
Administrator (0x4) The administrator role is defined.

Remarks

The role is determined by the access control list on the AD RMS Administration Web site.

Example Code

DIM config_manager
DIM admin_role

' *******************************************************************
' Create and initialize a ConfigurationManager object.

SUB InitObject()

  CALL WScript.Echo( "Create ConfigurationManager object...")
  SET config_manager = CreateObject _
    ("Microsoft.RightsManagementServices.Admin.ConfigurationManager")      
  CheckError()
    
  CALL WScript.Echo( "Initialize...")
  admin_role=config_manager.Initialize(false,"localhost",80,"","","")
  CheckError()

END SUB

' *******************************************************************
' Retrieve the roles.

SUB GetUserRoles()

  admin_role = config_manager.Roles
  CheckError()

END SUB


' *******************************************************************
' Error checking function.

FUNCTION CheckError()
  CheckError = Err.number
  IF Err.number <> 0 THEN
    CALL WScript.Echo( vbTab & "*****Error Number: " _
                       & Err.number _
                       & " Desc:" _
                       & Err.Description _
                       & "*****")
    WScript.StdErr.Write(Err.Description)
    WScript.Quit( Err.number )
  END IF
END FUNCTION

' *******************************************************************
' Generate a runtime error.

SUB RaiseError(errId, desc)
  CALL Err.Raise( errId, "", desc )
  CheckError()
END SUB

Requirements

Product Requires Windows ServerĀ "Longhorn".
Library

Use Microsoft.RightsManagementServices.Admin.dll registered as a custom type library.

See Also

ConfigurationManager