Add Method of the IFPCLinkTranslationPatterns Interface

The Add method adds a new pattern matching expression to the collection.

[C++]

Syntax

HRESULT Add(
  [in]  BSTR Name
);

Parameters

Name
Required. BSTR that specifies the new pattern matching expression.

Each pattern matching expression in the collection must have either the form A*B or the form A. In the former case, the search pattern is <!--A*B-->, and in the latter case, the search pattern is <!--A-->.

Return Value

This method returns S_OK if the call is successful; otherwise, it returns an error code.
[Visual Basic]

Syntax

Sub Add( _
  ByVal Name As String _
)

Parameters

Name
Required. String that specifies the new pattern matching expression.

Each pattern matching expression in the collection must have either the form A*B or the form A. In the former case, the search pattern is <!--A*B-->, and in the latter case, the search pattern is <!--A-->.

Return Value

This method has no return values. If the call is unsuccessful, an error is raised that can be intercepted by using an error handler.

Remarks

As an example of a pattern matching expression of the form A*B, consider the predefined pattern matching expression CURRENT FILE==*replyforwardnote for the scenario in which an internal user sends an e-mail message containing URLs that contain names of internal servers. If a recipient accesses the message through a Forefront TMG computer by using Microsoft Office Outlook Web Access for Exchange Server 2003, the URLs viewed by the recipient contain public names.

Forefront TMG uses pattern matching to ensure that the public names remain in links when a message is forwarded or a reply is sent. Replies and forwarded Microsoft Outlook Web Access messages contain the following line:

<!--CURRENT FILE==”IE5” “WIN32” replyforwardnote-->

Forefront TMG uses the predefined pattern matching expression to determine if a line like this is present by searching for a string that starts with <!--CURRENT FILE== and ends with replyforwardnote--> and does not contain < or > in between. When Forefront TMG identifies such a line, it does not perform link translation so that internal recipients will receive URLs with internal names.

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.
DLL

Requires Msfpccom.dll.

See Also

FPCLinkTranslationPatterns


Send comments about this topic to Microsoft

Build date: 11/30/2009

 

© 2008 Microsoft Corporation. All rights reserved.