FPCUrlToCategoryMapping Object
The FPCUrlToCategoryMapping object 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 creating a new FPCUrlToCategoryMapping object.
The FPCUrlToCategoryMapping object is an element of an FPCUrlToCategoryMappings collection, and a new object representing a mapping of a URL to an overriding URL category can be created by calling the Add method of this collection.
.png "Ff796914.bkbutton(en-us,MSDN.10).png")
Click here to see the Forefront TMG object hierarchy.
Methods
The FPCUrlToCategoryMapping object defines the following method.
| Method | Description |
|---|---|
Sets the overriding URL category in the mapping based on the URL category identifier specified. |
Properties
The FPCUrlToCategoryMapping object defines the following properties.
| Property | Description |
|---|---|
Gets or sets the URL that is mapped. |
|
Gets an FPCRef object that references the FPCUrlCategory object representing the overriding URL category in the mapping. |
Methods Inherited from FPCPersist
| Name | Description |
|---|---|
| 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 object's properties can be imported from the specified XML document. |
| Export | Writes the stored values of all of the object's properties to the specified XML document. |
| ExportToFile | Writes the stored values of all of the object's properties 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 | Copies the values of all of the object's properties from the specified XML document to persistent storage. |
| ImportFromFile | Copies the values of all of the object's properties 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 | Reads the values of all of the object's properties from persistent storage, overwriting any changes that have not been saved. |
| Save | Writes the current values of all of the object's properties 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
| Name | Description |
|---|---|
| PersistentName | Gets the persistent name of the object. 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 object that can hold sets of custom data for extending the object. |
Interfaces for C++ Programming
This object implements the IFPCUrlToCategoryMapping interface.
Requirements
| Client | Requires Windows 7 or Windows Vista. |
| Server | Requires Windows Server 2008 R2 or Windows Server 2008 x64 Edition with SP2. |
| Version | Requires Forefront Threat Management Gateway (TMG) 2010. |
| IDL | Declared in Msfpccom.idl. |
See Also
Send comments about this topic to Microsoft
Build date: 6/30/2010