RedirectUrl Property of the IFPCAccessProperties Interface

Article
08/13/2010

The RedirectUrl property gets or sets the URL to which HTTP requests blocked by the rule will be redirected.

C++

HRESULT put_RedirectUrl(
    BSTR bstrRedirectUrl
);
HRESULT get_RedirectUrl(
    BSTR* pbstrRedirectUrl
);

Parameters

bstrRedirectUrl
BSTR that specifies the URL to which HTTP requests blocked by the rule will be redirected.
pbstrRedirectUrl
Pointer to a BSTR that is set on return to a string value specifying the URL to which HTTP requests blocked by the rule will be redirected.

Return Value

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

Visual Basic

Property RedirectUrl As String

Property Value

String that specifies the URL to which HTTP requests blocked by the rule will be redirected.

Remarks

This property is read/write. Its default value is an empty string.

This property is applicable only if the Action property of the rule is set to fpcPolicyRuleActionDeny. If a URL is specified, Forefront TMG returns the URL specified to the client or user when an HTTP request is blocked by the rule. The URL must be specified in the format used in the following example: "https://widgets.microsoft.com/denied.htm"

Note If you choose to redirect requests, the URL that you specify must be accessible to the clients or users selected. In other words, either the URL must be on an internal computer or some rule must explicitly allow access to the URL.

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.

Share via