FPCScheduledContentDownloadConfig object
Applies to: desktop apps only
The FPCScheduledContentDownloadConfig object defines a single content download job contained in the FPCScheduledContentDownload collection. This collection allows you to create a list of content download jobs and access their properties.
With the Microsoft Forefront TMG Job Scheduler service, you can download Hypertext Transfer Protocol (HTTP) content directly to the Forefront TMG cache upon request or according to a schedule. Using this prefetching feature, you can update the Forefront TMG cache with HTTP content that you anticipate will be requested by clients in your organization, so that the content will be available for access directly from the Forefront TMG cache, rather than from the Internet.
A content download job can be scheduled to run only once on a specified date, to run every day, or to run on specified days of the week. A content download job that runs on more than one day can be scheduled to run once on each day or to run repeatedly on each day.
Each content download job is configured to download HTTP files from a specified URL to the Forefront TMG cache. A job can be configured to follow links to a specified maximum depth and to download content only from the domain of the root URL, or from other domains as well.
A content download job can run only if:
- There is a Web listener (an FPCWebListener object) that listens for requests from the Local Host network.
- The Scheduled Download Jobs system policy configuration group is enabled (see the Enabled property of the FPCSystemPolicyConfigGroup object), or an access rule that allows HTTP traffic to the All Networks network set from the Local Host network is enabled.
- The Microsoft Firewall service and the Microsoft Forefront TMG Job Scheduler service are running (see the FirewallServiceStatus and JobSchedulerServiceStatus properties of the applicable FPCServer object).
- The Web proxy is enabled (see the Enabled property of the FPCApplicationFilter object representing the Web Proxy Filter add-in).
In addition, downloaded content can be stored in the Forefront TMG cache only if a cache drive with a size (CacheLimitInMegs) greater than zero is configured.
The FPCScheduledContentDownloadConfig object is created as an element of an FPCScheduledContentDownload collection.
.png "Ff826220.bkbutton(en-us,VS.85).png")
Click here to see the Forefront TMG object hierarchy.
Inheritance
This object 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 the object's data to and importing it from an XML document.
Members
The FPCScheduledContentDownloadConfig object has these types of members:
- Methods
- Properties
Methods
The FPCScheduledContentDownloadConfig object has these methods.
| Method | Description |
|---|---|
| AbortOnAllServers | Stops the content download job. |
| Run | Runs the content download job. |
| SetDailyFrequency | Sets the hour and minute parts of the start and end times for repeated runs on a single day. |
| SetTaskPeriod | Sets the values of the TaskPeriod property (the type of schedule) and the ScheduleDays property (the days of the week on which the content download job will run) of the content download job. |
Properties
The FPCScheduledContentDownloadConfig object has these properties.
| Property | Access type | Description |
|---|---|---|
| Read-only | Gets the hour part of the end time for repeated runs on a single day. |
|
| Read-only | Gets the minute part of the end time for repeated runs on a single day. |
|
| Read-only | Gets the hour part of the start time for repeated runs on a single day. |
|
| Read-only | Gets the minute part of the start time for repeated runs on a single day. |
|
| Read/write | Gets or sets a value from the FpcTimeScale enumerated type that specifies the time units of the repetition time for repeated runs on a single day. |
|
| Read/write | Gets or sets the repetition time for repeated runs on a single day in the units specified by the DailyFreqTimeUnits property. |
|
| Read/write | Gets or sets a value from the FpcDailyFrequency enumerated type that specifies whether the download job is to run once on a single day or more than once on a single day. |
|
| Read/write | Gets or sets the hour part of the time for a one-time run on a single day. |
|
| Read/write | Gets or sets the minute part of the time for a one-time run on a single day. |
|
| Read/write | Gets or sets the description of the content download job. |
|
| Read/write | Gets or sets the hour part of the start time for a content download job that runs only once. |
|
| Read/write | Gets or sets the minute part of the start time for a content download job that runs only once. |
|
| Read/write | Gets or sets a Boolean value that indicates whether the content download job is enabled. |
|
| Read/write | Gets or sets a value from the FpcCacheContent enumerated type that specifies the conditions under which content will be cached. |
|
| Read/write | Gets or sets a Boolean value that indicates whether the fpcFetchNoArrayRouting (FETCH_NO_ARRAY_ROUTING) flag is set in internal calls to the FetchUrl method. |
|
This property is obsolete. |
||
| Read/write | Gets or sets a Boolean value that indicates whether the fpcFetchTtlIfNone (FETCH_TTL_IF_NONE) flag is set in internal calls to the FetchUrl method. |
|
| Read/write | Gets or sets a Boolean value that indicates whether the fpcFetchTtlOverride (FETCH_TTL_OVERRIDE) flag is set in internal calls to the FetchUrl method. |
|
| Read/write | Gets or sets the upper limit of the depth to fetch. |
|
| Read/write | Gets or sets the upper limit of the total cache object size in kilobytes. |
|
| Read/write | Gets or sets the name of the content download job. |
|
| Read/write | Gets or sets the number of concurrent TCP connections that may be created for the content download job. |
|
| Read-only | Gets a bitmask of the FpcDaysOfWeek enumerated type that specifies the days of the week on which the content download job will run. |
|
| Read-only | Gets an FPCScheduledContentDownloadJobStatuses collection that contains the status of the scheduled content download job. |
|
| Read/write | Gets or sets the day part of the date to start the content download job. |
|
| Read/write | Gets or sets the month part of the date to start the content download job. |
|
| Read/write | Gets or sets the year part of the date to start the content download job. |
|
| Read/write | Gets or sets a Boolean value that indicates whether to download content only from the domain of the root URL, or from other domains as well. |
|
| Read-only | Gets a value from the FpcScheduledTaskRunningPeriod enumerated type that specifies whether the content download job is run only once, every day, or on specified days of the week. |
|
| Read/write | Gets or sets the Time to Live (TTL), in minutes, of the pages to be downloaded. |
|
| Read/write | Gets or sets the URL to be downloaded. |
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 | Recursively writes the stored values of all the properties of the object and its subobjects to the specified XML document. |
| ExportToFile | Recursively writes the stored values of all the properties of the object and its 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 object and of its subobjects from the specified XML document to persistent storage. |
| ImportFromFile | Recursively copies the values of all the properties of the object and of its 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 object and of its subobjects from persistent storage, overwriting any changes that have not been saved. |
| Save | Recursively writes the current values of all the properties of the object and its 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
| 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 collection that can hold sets of custom data for extending the object. |
Interfaces for C++ Programming
This object implements the IFPCScheduledContentDownloadConfig interface.
Requirements
Minimum supported client |
Windows Vista, None supported |
Minimum supported server |
Windows Server 2008 R2, Windows Server 2008 with SP2 (64-bit only) |
Version |
Forefront Threat Management Gateway (TMG) 2010 |
IDL |
Msfpccom.idl |
See also
Build date: 7/12/2010