Export (0) Print
Expand All
This topic has not yet been rated - Rate this topic

FPCContentTypeSet Collection

Internet Security and Acceleration Server 2004/2006 SDK

The FPCContentTypeSet collection can hold a list of MIME content types and file name extensions for Web content. Multiple MIME content types can specified in a single element of this collection using an asterisk (*) as a wildcard character. For example, application/* includes all application types.

The following predefined content type sets are supplied with ISA Server:

  • Application
  • Application Data Files
  • Audio
  • Compressed Files
  • Documents
  • HTML Documents
  • Images
  • Macro Documents
  • Text
  • Video
  • VRML

A content type set can include file name extensions. For example, the default Audio content type set includes the file name extensions .aif, .aifc, .au, .m3u, .mid, .mp3, .ra, .ram, .rmi, .snd, and .wav. The file name extensions that are included in a content type set can be changed by calling the Add and Remove methods of the FPCContentTypeSet collection.

To configure granular security policies, access rules can be limited to specific MIME content types or file name extensions by setting their AppliesToContent Method property to fpcAppliesToSpecifiedContent and including references to the applicable content type sets in the FPCRefs collection held in their ContentTypeSetsUsed property. Content type sets can be referenced only in access rules that apply to HTTP and tunneled FTP traffic and are not applicable to any other protocols (for example, HTTPS).

When a Web proxy client specifies the HTTP or FTP protocol in a URL request and an access rule allows access to the destination, the ISA Server Web proxy forwards the request to the Web server. When a response is provided by the Web server, the Web proxy re-examines the access rules to determine whether there is an access rule that references a content type set containing the MIME content type specified in a Content-Type header in the response or its file name extension. If such a rule is found, the Web proxy performs its action. For requests that specify the HTTP protocol, only the responses can contain Content-Type headers. Responses to requests that specify the FTP protocol do not contain Content-Type headers, but the MIME content type of a response containing a folder listing is defined as text/html. For both protocols, the file name extension is checked only for responses that do not have a defined MIME content type.

The names of content type sets are also specified as the names of parameters in a specific FPCVendorParametersSet object associated with the Link Translation Filter add-in to indicate the Content-Type headers for which link translation should be applied to the message body when link translation is enabled.

The content type sets for which HTTP compression is enabled or disabled are specified by including references to the applicable FPCContentTypeSet collections in the FPCRefs collection held in the CompressibleContentTypeSets property of the FPCHTTPCompressionConfiguration object (introduced in ISA Server 2006).

In ISA Server Enterprise Edition, the preconfigured content type sets are defined on the enterprise level, and enterprise administrators can create additional enterprise-level content type sets. Enterprise-level content type sets can be used in array-level access rules and in enterprise-level access rules. Array-level content types can be used only in access rules for the array in which they are defined.

The FPCContentTypeSet collection is an element of an FPCContentTypeSets collection, and a new object representing an additional content type set can be created using the Add method of the FPCContentTypeSets collection.

Click here to see the ISA Server object hierarchy.

Inheritance

This collection inherits from the FPCPersist object, which contains methods and properties related to the persistent storage of an object's data. They include methods for exporting an object's data to and importing it from an XML document.

Methods

The FPCContentTypeSet collection defines the following methods.

Method Description
Add Adds a new MIME content type or file name extension to the content type set.
Item Retrieves the requested MIME content type or file name extension from the content type set.
Remove Removes the specified MIME content type or file name extension from the content type set.
RemoveAll Removes all of the MIME content types and file name extensions from the content type set.

Properties

The FPCContentTypeSet collection has the following properties.

Property Description
_NewEnum Gets an enumerator object for the collection.
Count Gets the total number of MIME content types and file name extensions in the content type set.
Description Gets or sets the description of the content type set.
Name Gets or sets the name of the content type set.
Predefined Gets a Boolean value that indicates whether the content type set is a predefined content type set that was created during the installation of ISA Server and cannot be deleted. (This property is introduced in ISA Server 2006.)

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 collection's properties and elements can be imported from the specified XML document.
Export Writes the stored values of the collection's properties and elements to the specified XML document.
ExportToFile Writes the stored values of the collection's properties and elements 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 the collection's properties and elements from the specified XML document to persistent storage.
ImportFromFile Copies the values of the collection's properties and elements 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 the collection's properties and elements from persistent storage, overwriting any changes that have not been saved.
Save Writes the current values of the collection's properties and elements 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 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.
VendorParametersSets Gets an FPCVendorParametersSets collection that can hold sets of custom data for extending the collection.

Interfaces for C++ Programming

This collection implements the IFPCContentTypeSet and IFPCContentTypeSet2 interfaces.

Requirements

Client Requires Windows XP.
Server Requires Windows Server 2003. Requires Windows Server 2003 or Windows 2000 for ISA Server 2004 Standard Edition.
Version Requires Internet Security and Acceleration (ISA) Server 2006 or ISA Server 2004.
IDL

Declared in Msfpccom.idl.

See Also

COM Objects

Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft. All rights reserved.