IFPCWebPublishingProperties::TranslateLinks property

Article
08/27/2012

Applies to: desktop apps only

The TranslateLinks property gets or sets a Boolean value that indicates whether private names in links on Web pages are to be translated to public names.

This property is read/write.

Syntax

HRESULT put_TranslateLinks(
  VARIANT_BOOL fTranslateLinks
);

HRESULT get_TranslateLinks(
  VARIANT_BOOL *pfTranslateLinks
);

' Data type: Boolean

Property TranslateLinks( _
  ByVal fTranslateLinks As VARIANT_BOOL, _
  ByVal pfTranslateLinks As VARIANT_BOOL _
) As Boolean

Property value

Boolean value that indicates whether private names in links on Web pages are to be translated to public names.

Error codes

These property methods return S_OK if the call is successful; otherwise, they return an error code.

Remarks

This property is read/write. Its default value is False (VARIANT_FALSE in C++).

When this property is set to True (VARIANT_TRUE in C++), a built-in Web filter named Link Translation Filter translates private host names in links on Web pages sent back to clients from the Web server published by the rule according to a default dictionary that is based on the name (or IP address) of the server published by the rule and the public names (and IP addresses) of the Web site, or according to a user-defined dictionary that maps strings containing private host names to strings containing publicly resolvable host names and is stored in the VendorParametersSets property of the rule.

Link translation is performed only if the type of message body specified in the Content-Type header of the response is included in one of the translatable content type sets specified in a global vendor parameters set for all Web publishing rules in the VendorParametersSets property of the Web filter. By default, link translation is applied only to the content types included in the HTML Documents content type set, although other content type sets can be specified. Note that Forefront TMG performs link translation only on strings that are specified in UCS Transformation Format 8 (UTF-8) format in HTML documents.

Requirements

Minimum supported client	Windows Vista
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
DLL	Msfpccom.dll

Share via