FPCArrays.Add Method

Adds a new array to the collection.

Note  Unlike other ISA COM object Add methods, the addition of an array takes place without calling a Save method.

This method is available only for an array in ISA Server Enterprise Edition. It is not available for a stand-alone server, or for ISA Server Standard Edition.

VBScript Syntax[VBScript]

[oFPCArray = ] FPCArrays.Add( sName, sDomainName, sSiteName, lComponents, ArrayToClone bUseDefaultPolicySettings, PolicyUsedFlag, sPolicy )

C++ Syntax[C++]

HRESULT Add( 
  BSTR sName,
  BSTR sDomainName,
  BSTR sSiteName,
  LONG lComponents,
  IDispatch *pArrayToClone,
  VARIANT_BOOL bUseDefaultPolicySettings,
  FpcPolicyUsed PolicyUsedFlag,
  BSTR sPolicy,
  IFPCArray **ppoFPCArray
);

Parameters

sName

The name of the array.

sDomainName

Optional. String that specifies the domain name in which to create the array.

sSiteName

Required. Name of FPCArray object to add.

lComponents

Long value that specifies the component flags, using values from the FpcComponents enumerated type.

bUseDefaultPolicySettings

Boolean value that specifies whether the default policy settings are used. If FALSE, the policy is configured using the PolicyUsedFlag and sPolicy parameters. This parameter is ignored if the ArraytoClone parameter is not NULL because the configuration is copied from the specified array.

PolicyUsedFlag

The policy that is used. It can have a value from the FpcPolicyUsed enumerated type. Has a default value of fpcEnterprisePolicyUsed. This parameter is meaningless if bUseDefaultPolicySettings is set to TRUE. This parameter is ignored if the ArraytoClone parameter is not NULL because the configuration is copied from the specified array.

sPolicy

String value specifying the name of the policy to use. This parameter is meaningless when only array policy is used, or if bUseDefaultPolicySettings is set to TRUE. This parameter is ignored if the ArraytoClone parameter is not NULL because the configuration is copied from the specified array.

ArrayToClone

Optional. Array name from which to copy the configuration.

Return Value

oFPCArray

Reference to the added FPCArray object.

Applies To

FPCArrays Collection