Microsoft Internet Security and Acceleration Server 2004 SDK

IFPCRefs::Add[C++]

FPCRefs.Add [Visual Basic]

[C++]

The Add method creates a new FPCRef object in the collection and returns a reference to it.

HRESULT Add(
  BSTR Name,
  FpcIncludeStatus IncludeStatus,
  IFPCRef** ppNewRef
);

Parameters

Name
[in] Required. BSTR that specifies the name of the new object.
IncludeStatus
[in] Required. Value from the FpcIncludeStatus enumerated type that specifies whether the referenced item will be included in or excluded from the list of items to which a rule applies.
ppNewRef
[out] Address of an interface pointer that on return points to the new IFPCRef interface added.

Return Values

This method can return one of the following:

Remarks

The IncludeStatus parameter must be set even when the collection is accessed through a property for which this parameter is meaningless, such as the SpecifiedProtocols property of the FPCAccessProperties object. Here the inclusion of the specified protocols in the rule, or their exclusion from the rule, is indicated by the ProtocolSelectionMethod property.

[Visual Basic]

The Add method creates a new FPCRef object in the collection and returns a reference to it.

Function Add( _
  ByVal Name As String, _
  ByVal IncludeStatus As FpcIncludeStatus _
) As FPCRef

Parameters

Name
[in] Required. String that specifies the name of the new object.
IncludeStatus
[in] Required. Value from the FpcIncludeStatus enumerated type that specifies whether the referenced item will be included in or excluded from the list of items to which a rule applies.

Return Values

This method returns a reference to the FPCRef object added if the call is successful. Otherwise, an error is raised that can be intercepted by using an error handler.

Remarks

The IncludeStatus parameter must be set even when the collection is accessed through a property for which this parameter is meaningless, such as the SpecifiedProtocols property of the FPCAccessProperties object. Here the inclusion of the specified protocols in the rule, or their exclusion from the rule, is indicated by the ProtocolSelectionMethod property.

Requirements

Server: Requires Windows Server 2003 or Windows 2000.
Version: Requires Internet Security and Acceleration Server 2004.
Header: Declared in Msfpccom.idl.
Library: Use Microsoft Internet Security and Acceleration Server 2004 Administration Library.

See Also

FPCRefs