TranslateLinks Property of the IFPCWebPublishingProperties Interface

Article
08/13/2010

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.

C++

HRESULT put_TranslateLinks(
    VARIANT_BOOL fTranslateLinks
);
HRESULT get_TranslateLinks(
    VARIANT_BOOL* pfTranslateLinks
);

Parameters

fTranslateLinks
Boolean value that indicates whether private names in links on Web pages are to be translated to public names.
pfTranslateLinks
Pointer to a Boolean variable that is set on return to VARIANT_TRUE if private names in links on Web pages are to be translated to public names, or to VARIANT_FALSE if private names in links on Web pages are not to be translated to public names.

Return Value

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

Visual Basic

Property TranslateLinks As Boolean

Property Value

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

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

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.
DLL	Requires Msfpccom.dll.