Share via


FPCWebProxy Object

The FPCWebProxy object defines the configuration settings for the Forefront TMG Web proxy in a Forefront TMG array.

The FPCWebProxy object is accessed through the WebProxy property of the FPCArrayPolicy object.

Dd447616.bkbutton(en-us,MSDN.10).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.

Methods

The FPCWebProxy object defines the following method.

Method Description

TestConnectivity

Performs a connectivity test to the specified web server.

Properties

The FPCWebProxy object defines the following properties.

Property Description

ApplyPutAndDeleteInForward

Gets or sets a Boolean value that indicates whether the Forefront TMG Web proxy will delete the corresponding object currently stored in the cache when PUT and DELETE requests are received in the forward proxy scenario.

ApplyPutAndDeleteInReverse

Gets or sets a Boolean value that indicates whether the Forefront TMG Web proxy will delete the corresponding object currently stored in the cache when PUT and DELETE requests are received in the reverse proxy scenario.

BlockInvalidUtf8Urls

Gets or sets a Boolean value that indicates whether requests with an invalid UTF8-encoded URL will be blocked.

CARPExceptions

Gets an FPCRefs collection that contains references to the FPCDomainNameSet collections defining the domain name sets which make up the list of Web sites to which requests are sent without using the Cache Array Routing Protocol (CARP).

CARPNameSystem

Gets or sets a value from the FpcNameSystem enumerated type that specifies the method to be used by Web browsers for resolving the names of array members to which they are to connect according to the CARP algorithm.

ConnectCacheSize

Gets or sets a value that is a factor for determining the maximum size of the connection cache.

CookieCryptoConfiguration

Gets an FPCCookieCryptoConfiguration object that holds the configuration settings used for cookie hashing and encryption in forms-based authentication.

EnforceLogUrlLengthInWebProxy

Gets or sets a Boolean value that indicates whether the Forefront TMG Web proxy will reject requests with URLs that are longer than the maximum length that can be logged.

ExplicitLinkTranslationMappings

Gets an FPCExplicitLinkTranslationMappings collection that contains objects representing all the explicit link translation mappings defined in the array.

HTTPCompressionConfiguration

Gets an FPCHTTPCompressionConfiguration object that holds the configuration settings for Hypertext Transfer Protocol (HTTP) compression.

LinkTranslationEnabled

Gets or sets a Boolean value that indicates whether link translation can be enabled in Web publishing rules.

LinkTranslationRedirection

Gets an FPCLinkTranslationRedirection object that holds the configuration settings for redirecting links to unpublished sites in link translation.

MaxResponseHeadersSize

Gets or sets the maximum allowed size, in bytes, of an HTTP response header.

OutboundHTTPSInspectionConfiguration

Gets an FPCOutboundHTTPSInspectionConfiguration object that holds the configuration settings for outbound HTTPS inspection.

PerfCounterSettings

Gets an FPCPerfCounterSettings object that holds the configuration settings of the Web proxy performance counters.

RemoveAllProxyAuthorization

Gets or sets a Boolean value that indicates whether the Forefront TMG Web proxy will remove all Proxy-Authorization headers from requests passed to an upstream server.

RemoveRedundantProxyAuthorization

Gets or sets a Boolean value that indicates whether the Forefront TMG Web proxy will remove all redundant Proxy-Authorization headers from requests passed to an upstream server when Basic authentication is used for authentication to the upstream server.

RemoveTrailersFromChunkedEncodedRequests

Gets or sets a Boolean value that indicates whether the Forefront TMG Web proxy will remove trailers from requests that are encoded with the chunked transfer coding (this property is relevant only for responses sent to HTTP 1.1 clients).

RemoveTrailersFromChunkedEncodedResponses

Gets or sets a Boolean value that indicates whether the Forefront TMG Web proxy will remove trailers from responses that are encoded with the chunked transfer coding (this property is relevant only for responses sent to HTTP 1.1 clients).

SkipAuthenticationForRoutingInformation

Gets or sets a Boolean value that indicates whether the Forefront TMG Web proxy will skip the authentication process for requests for routing information.

SkipNameResolutionForAccessAndRoutingRules

Gets or sets a Boolean value that indicates whether the Forefront TMG Web proxy will skip name resolution while checking access and routing rules.

SkipNameResolutionForWebPublishingRules

Gets or sets a Boolean value that indicates whether the Forefront TMG Web proxy will skip name resolution while checking Web publishing rules.

TunnelPortRanges

Gets an FPCTunnelPortRanges collection.

UpstreamResolveSystem

Gets or sets a value from the FpcNameSystem enumerated type that specifies the method that the Forefront TMG Web proxy will use for resolving the names of upstream array members to which it is to connect according to the CARP algorithm.

UrlFilteringSettings

Gets an FPCUrlFilteringSettings object that holds the URL filtering settings for the array.

UseDigestSSP

Gets or sets a Boolean value that indicates whether the Forefront TMG Web proxy will prefer Advanced Digest authentication over Digest authentication.

ValidateClientCertificateCRL

Gets or sets a Boolean value that indicates whether the Forefront TMG Web proxy will validate client certificates against the relevant certificate revocation list (CRL).

ValidateCrlOnline

Gets or sets a Boolean value that indicates whether the Forefront TMG Web proxy will try to connect to the certification authority (CA) and download the latest certificate revocation list (CRL).

ValidateServerCertificateCRLInForward

Gets or sets a Boolean value that indicates whether the Forefront TMG Web proxy will validate server certificates against the relevant certificate revocation list (CRL) in the forward proxy scenario.

ValidateServerCertificateCRLInReverse

Gets or sets a Boolean value that indicates whether the Forefront TMG Web proxy will validate server certificates against the relevant certificate revocation list (CRL) in the reverse proxy scenario.

WebProxyFtpClientPassword

Gets or sets the password that will be used when mediating anonymous FTP requests.

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 IFPCWebProxy, IFPCEEWebProxy, IFPCWebProxy2, and IFPCWebProxy3 interfaces.

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

COM Objects

Send comments about this topic to Microsoft

Build date: 6/30/2010