Add Method of the IFPCRefs Interface

[C++]

Syntax

HRESULT Add(
  [in]   BSTR Name,
  [in]   FpcIncludeStatus IncludeStatus,
  [out]  IFPCRef** ppNewRef
);

Parameters

Name

Required. BSTR that specifies the name of the item that will be referenced by the new object.

IncludeStatus

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

Address of an interface pointer that on return points to the new IFPCRef interface created.

Return Value

This method can return one of the following:

• S_OK, indicating that the operation succeeded.
• An error code, indicating that the operation failed. In this case, the [out] parameter returned is a null object.

[Visual Basic]

Syntax

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

Parameters

Name

Required. String that specifies the name of the item that will be referenced by the new object.

IncludeStatus

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 Value

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.

Example Code

For VBScript code examples that show how to use this method to add references to networks, URL sets, and protocols for use in access rules, see Adding an Access Rule and Controlling Access by a Schedule and a User Set.