SpecifiedProtocols Property

SpecifiedProtocols Property of IFPCAccessProperties[C++] | FPCAccessProperties.SpecifiedProtocols [Visual Basic]

Internet Security and Acceleration Server 2004/2006 SDK

The SpecifiedProtocols property gets an FPCRefs collection that contains references to the FPCProtocolDefinition objects defining the protocols to which the rule applies or the protocols that are excluded from the rule.


HRESULT get_SpecifiedProtocols(
  IFPCRefs** ppRefs );

Parameters

ppRefs
Address of an interface pointer that on return points to an IFPCRefs interface that represents the collection of references to the protocols to which the rule applies or the protocols that are excluded from the rule.

Return Values

This property method returns S_OK if the call is successful; otherwise, it returns an error code.

Remarks

This property is read-only. It can be modified by calling the methods of the IFPCRefs interface retrieved.

The ProtocolSelectionMethod property indicates whether the rule applies to all protocols, to the protocols referenced by this property, or to all protocols except the protocols referenced by this property.

The SpecifiedProtocols property gets an FPCRefs collection that contains references to the FPCProtocolDefinition objects defining the protocols to which the rule applies or the protocols that are excluded from the rule.


Property SpecifiedProtocols As FPCRefs

Property Value

Reference to an FPCRefs collection that contains references to the protocols to which the rule applies or the protocols that are excluded from the rule.

Remarks

This property is read-only. It can be modified by calling the methods of the FPCRefs collection retrieved.

The ProtocolSelectionMethod property indicates whether the rule applies to all protocols, to the protocols referenced by this property, or to all protocols except the protocols referenced by this property.

Example Code

The following Visual Basic code illustrates the use of the SpecifiedProtocols property.

   Dim root As New FPCLib.FPC
  Dim containingArray As FPCArray
  Dim policyRules As FPCPolicyRules
  Dim newRule As FPCPolicyRule  

  Set containingArray = root.GetContainingArray
  Set policyRules = containingArray.ArrayPolicy.PolicyRules
  Set newRule = policyRules.AddAccessRule("All Web Access")
  newRule.Action = fpcActionAllow
  newRule.Description = "Basic Web access to Everyone"
  newRule.Enabled = True
  newRule.AccessProperties.ProtocolSelectionMethod = fpcSpecifiedProtocols
  newRule.AccessProperties.SpecifiedProtocols.Add ("HTTP", fpcInclude)
  newRule.AccessProperties.SpecifiedProtocols.Add ("HTTPS", fpcInclude)
  newRule.SetAppliesAlways
  policyRules.Save

Requirements

Client Requires Windows XP.
Server Requires Windows Server 2003. Requires Windows Server 2003 or Windows 2000 for ISA Server 2004 Standard Edition.
Version Requires Internet Security and Acceleration (ISA) Server 2006 or ISA Server 2004.
IDL

Declared in Msfpccom.idl.

DLL Requires Msfpccom.dll.

See Also

FPCAccessProperties

Show:
© 2016 Microsoft