FPCScheduledContentDownloadConfig Object

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.

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.

Methods

The FPCScheduledContentDownloadConfig object defines the following 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 defines the following properties.

Property	Description
DailyFreqEndHour	Gets the hour part of the end time for repeated runs on a single day.
DailyFreqEndMinute	Gets the minute part of the end time for repeated runs on a single day.
DailyFreqStartHour	Gets the hour part of the start time for repeated runs on a single day.
DailyFreqStartMinute	Gets the minute part of the start time for repeated runs on a single day.
DailyFreqTimeUnits	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.
DailyFreqTimeValue	Gets or sets the repetition time for repeated runs on a single day in the units specified by the DailyFreqTimeUnits property.
DailyFrequency	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.
DailyHour	Gets or sets the hour part of the time for a one-time run on a single day.
DailyMinute	Gets or sets the minute part of the time for a one-time run on a single day.
Description	Gets or sets the description of the content download job.
DownloadOnceHour	Gets or sets the hour part of the start time for a content download job that runs only once.
DownloadOnceMinute	Gets or sets the minute part of the start time for a content download job that runs only once.
Enabled	Gets or sets a Boolean value that indicates whether the content download job is enabled.
FetchUrlCacheContent	Gets or sets a value from the FpcCacheContent enumerated type that specifies the conditions under which content will be cached.
FetchUrlFlagNoArrayRoute	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.
FetchUrlFlagSync	This property is obsolete.
FetchUrlFlagTtlIfNone	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.
FetchUrlFlagTtlOverride	Gets or sets a Boolean value that indicates whether the fpcFetchTtlOverride (FETCH_TTL_OVERRIDE) flag is set in internal calls to the FetchUrl method.
MaxDepth	Gets or sets the upper limit of the depth to fetch.
MaxPages	Gets or sets the upper limit of the total cache object size in kilobytes.
Name	Gets or sets the name of the content download job.
NumberOfConcurrentConnections	Gets or sets the number of concurrent TCP connections that may be created for the content download job.
ScheduleDays	Gets a bitmask of the FpcDaysOfWeek enumerated type that specifies the days of the week on which the content download job will run.
ScheduledContentDownloadJobStatuses	Gets an FPCScheduledContentDownloadJobStatuses collection that contains the status of the scheduled content download job.
StartDateDay	Gets or sets the day part of the date to start the content download job.
StartDateMonth	Gets or sets the month part of the date to start the content download job.
StartDateYear	Gets or sets the year part of the date to start the content download job.
StayInDomain	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.
TaskPeriod	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.
TTL	Gets or sets the Time to Live (TTL), in minutes, of the pages to be downloaded.
URL	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

Client	Requires Windows Vista or Windows XP.
Server	Requires Windows Server 2008.
Version	Requires Forefront Threat Management Gateway (TMG).
IDL	Declared in Msfpccom.idl.