ApplicationSpecificDataItemCollection object
The ApplicationSpecificDataItemCollection object contains a collection of ApplicationSpecificDataItem objects. The application-specific data defined in this object consists of a name-value pair that can be used to identify an application that will not be allowed to consume content. You can retrieve the collection by calling the ApplicationSpecificDataItems property on the RightsTemplate object.
Members
The ApplicationSpecificDataItemCollection object has these types of members:
Methods
The ApplicationSpecificDataItemCollection object has these methods.
Method | Description |
---|---|
Add | Adds an object to the collection (inherited from IList). |
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). |
IndexOf | Retrieves the index of a specific object in the collection (inherited from IList). |
Insert | Inserts an object in the collection at the specified index (inherited from IList). |
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 ApplicationSpecificDataItemCollection 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
' *******************************************************************
' Create a template and add it to the template collection.
SUB ExcludeApplication()
DIM template_manager
DIM templateColl
DIM templateObj
' Retrieve the RightsTemplatePolicy object.
SET template_manager = config_manager.RightsTemplatePolicy
CheckError()
' Retrieve the rights template collection.
SET templateColl = template_manager.RightsTemplateCollection
CheckError()
' Retrieve the first template in the collection.
SET templateObj = template_manager.RightsTemplateCollection.Item(0)
CheckError()
' Identify an excluded application.
SET appData = CreateObject( _
"Microsoft.RightsManagementServices.Admin.ApplicationSpecificDataItem")
appData.Name = "NOTE PAD"
appData.Value = "Notepad.exe"
templateObj.ApplicationSpecificDataItems.Add( appData )
CheckError()
' Update the templates on the server.
template_manager.RightsTemplateCollection.Update( templateObj )
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 |
|