TrustedUserDomainCollection object
The TrustedUserDomainCollection object contains a collection of TrustedUserDomain objects. The collection enables AD RMS to process license requests from users whose rights account certificates (RACs) were issued by AD RMS installations in other forests. To import the external domains associated with another AD RMS installation, you can call the Import method and specify the external server licensor certificate. You can retrieve the collection by calling the TrustedUserDomains property on the TrustPolicy object.
Members
The TrustedUserDomainCollection object has these types of members:
Methods
The TrustedUserDomainCollection object has these methods.
Method | Description |
---|---|
Clear | Removes all objects from the collection (inherited from IList). |
Contains | Determines whether the collection contains a specific object (inherited from IList). |
CopyTo | Copies the collection elements to an array, starting at a specified index (inherited from ICollection). |
Import | Imports external trusted user domains into the collection. |
IndexOf | Retrieves the index of a specific object in the collection (inherited from IList). |
Refresh | Updates the current collection instance from the collection of trusted user domains on the server. |
Remove | Removes the first occurrence of the specified object from the collection (inherited from IList). |
RemoveAt | Removes the object at the specified index from the collection (inherited from IList). |
Properties
The TrustedUserDomainCollection object has these properties.
Property | Description |
---|---|
Count |
Retrieves the number of objects contained in the collection (inherited from ICollection). |
Item |
Specifies or retrieves the object at the specified index (inherited from IList). |
Examples
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 trusted user domain collection.
SUB GetTrustedUsers()
DIM trustPolicy
DIM tudColl
DIM Tud
' Retrieve the trust policy object.
SET trustPolicy = config_manager.Enterprise.TrustPolicy
CheckError()
' Retrieve the trusted user domain collection object.
SET tudColl = trustPolicy.TrustedUserDomains
CheckError()
' Remove all domains from the collection.
tudColl.Clear()
CheckError()
' Import new trusted user domains into the collection.
SET Tud = tudColl.Import( "TUD_Name", _
"c:\certFile.bin", _
False)
CheckError()
IF tudColl.Count < 1 OR IsNull(Tud.Id) THEN
CALL RaiseError(-610, "Import failed.")
END IF
' Remove the trusted user domain object.
tudColl.Remove( Tud )
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
Minimum supported client |
None supported |
Minimum supported server |
Windows Server 2008 |
Assembly |
|