Action Property of the IFPCPolicyRule Interface

Article
08/13/2010

The Action property gets or sets the type of action that this rule performs. The action may be to allow requests or deny requests.

C++

HRESULT put_Action(
    FpcPolicyRuleActions PolicyRuleActions
);
HRESULT get_Action(
    FpcPolicyRuleActions* pPolicyRuleActions
);

Parameters

PolicyRuleActions
Value from the FpcPolicyRuleActions enumerated type that specifies whether the rule allows or denies requests.
pPolicyRuleActions
Pointer to a value from the FpcPolicyRuleActions enumerated type that is set on return to either fpcPolicyRuleActionAllow, which indicates that the rule allows requests, or to fpcPolicyRuleActionDeny, which indicates that the rule denies requests.

Return Value

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

Visual Basic

Property Action As FpcPolicyRuleActions

Property Value

Value from the FpcPolicyRuleActions enumerated type. The possible values are fpcPolicyRuleActionAllow, which indicates that the rule allows requests, and fpcPolicyRuleActionDeny, which indicates that the rule denies requests.

Remarks

This property is read/write. The default value for an access rule is fpcPolicyRuleActionDeny, which indicates that the rule denies requests. The default value for a server publishing rule or a Web publishing rule is fpcPolicyRuleActionAllow, which indicates that the rule allows requests.

Because array policy can only be more restrictive than enterprise policy, you can only add array policy rules that deny access to what is already allowed by the enterprise. If you try to create an allow (fpcPolicyRuleActionAllow) policy rule, you receive an error message, and the rule is not created.

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