Applies to: desktop apps only
The FPCUrlToCategoryMappings collection holds a set of FPCUrlToCategoryMapping objects, each of which maps a URL to an overriding URL category.
Forefront TMG queries the Microsoft Reputation Service (MRS) to obtain a URL category for every URL to which client requests are directed and caches the results returned. If you want to override the URL category returned by this service for a specific URL, you can assign a different URL category to it by adding an FPCUrlToCategoryMapping object to this collection.
The FPCUrlToCategoryMappings collection is accessed through the following properties.
- The EntOverridingUrlCategories property of the FPCArray object (introduced in Forefront TMG 2010 SP1).
- The OverridingUrlCategories property of the FPCEnterprise object (introduced in Forefront TMG 2010 SP1).
- The OverridingUrlCategories property of the FPCUrlFilteringSettings object.
Click here to see the Forefront TMG object hierarchy.
This collection inherits from the FPCPersist object, which contains methods and properties related to persistent object storage. They include methods for exporting an object's configuration to and importing it from an XML document.
The FPCUrlToCategoryMappings object has these types of members:
The FPCUrlToCategoryMappings object has these methods.
Creates a new FPCUrlToCategoryMapping object in the collection and returns a reference to it.
Retrieves the requested FPCUrlToCategoryMapping object from the collection.
Removes the specified FPCUrlToCategoryMapping object from the collection.
The FPCUrlToCategoryMappings object has these properties.
Gets an enumerator object for the collection.
Gets the number of FPCUrlToCategoryMapping objects in the collection.
Methods Inherited from FPCPersist
|CancelWaitForChanges||Cancels the registration established by the WaitForChanges method (for use in C and C++ programming only).|
|CanImport||Returns a Boolean value that indicates whether the properties of the collection, its elements, and their subobjects can be imported from the specified XML document.|
|Export||Recursively writes the stored values of all the properties of the collection, its elements, and their subobjects to the specified XML document.|
|ExportToFile||Recursively writes the stored values of all the properties of the collection, its elements, and their subobjects to the specified XML file.|
|GetServiceRestartMask||Retrieves a 32-bit bitmask of the FpcServices enumerated type that specifies which services need to be restarted for currently unsaved changes to take effect.|
|Import||Recursively copies the values of all the properties of the collection, its elements, and their subobjects from the specified XML document to persistent storage.|
|ImportFromFile||Recursively copies the values of all the properties of the collection, its elements, and their subobjects from the specified XML file to persistent storage.|
|LoadDocProperties||Provides the XML document's properties so that you can know what information can be imported from the document.|
|Refresh||Recursively reads the values of all the properties of the collection, its elements, and their subobjects from persistent storage, overwriting any changes that have not been saved.|
|Save||Recursively writes the current values of all the properties of the collection, its elements, and their subobjects to persistent storage.|
|WaitForChanges||Registers to wait for an event indicating that the contents of the object have changed (for use in C and C++ programming only).|
Properties Inherited from FPCPersist
|PersistentName||Gets the persistent name of the collection. The persistent name of an object is a name that is unique for the object at the respective level of the COM object hierarchy.|
|VendorParameterSets||Gets an FPCVendorParametersSets collection that can hold sets of custom data for extending the collection.|
Interfaces for C++ Programming
This object implements the IFPCUrlToCategoryMappings interface.
Minimum supported client
|Windows Vista, None supported|
Minimum supported server
|Windows Server 2008 R2, Windows Server 2008 with SP2 (64-bit only)|
|Forefront Threat Management Gateway (TMG) 2010|
Build date: 7/12/2010