PrimaryTestingDelay Property of the IFPCEEConfigurationStorageServerConnection Interface

Article
08/13/2010

The PrimaryTestingDelay property gets or sets the time (in minutes) after which an array member will start testing for connectivity with the primary Configuration Storage server when using the alternate Configuration Storage server.

C++

HRESULT put_PrimaryTestingDelay(
    long lPrimaryTestingDelay
);
HRESULT get_PrimaryTestingDelay(
    long* plPrimaryTestingDelay
);

Parameters

lPrimaryTestingDelay
A 32-bit integer that specifies the time (in minutes) after which an array member will start testing for connectivity with the primary Configuration Storage server when using the alternate Configuration Storage server.
plPrimaryTestingDelay
Pointer to a variable that is set on return to a 32-bit integer specifying the time (in minutes) after which an array member will start testing for connectivity with the primary Configuration Storage server when using the alternate Configuration Storage server.

Return Value

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

Visual Basic

Property PrimaryTestingDelay As Long

Property Value

A 32-bit integer that specifies the time (in minutes) after which an array member will start testing for connectivity with the primary Configuration Storage server when using the alternate Configuration Storage server.

Example Code

When run on an array member, this VBScript subprocedure connects to the specified Configuration Storage server using the credentials provided and changes the value of the PrimaryTestingDelay property to the new value provided if necessary. This example does not include error handling.

Sub SetPrimaryTestingDelay(css, userName, domain, password, newValue)
    ' Declare the objects needed.
    Dim root          ' The FPCLib.FPC root object
    Dim isaArray      ' An FPCArray object
    Dim cssCn         ' An FPCConfigurationStorageServerConnection object
    Dim currentValue  ' An Integer
    ' Create the root object.
    Set root = CreateObject("FPC.Root")
    ' Connect to the Configuration Storage server.
    root.ConnectToConfigurationStorageServer css, userName, domain, password
    ' Get references to the array object 
    ' and the connection object.
    Set isaArray = root.GetContainingArray()
    Set cssCn = isaArray.ConfigurationStorageServerConnection
    ' Change the value of the property if necessary.
    currentValue = cssCn.PrimaryTestingDelay
    WScript.Echo "Current primary testing delay: " & currentValue
    If newValue <> currentValue Then
        cssCn.PrimaryTestingDelay = newValue
        WScript.Echo "Saving the new value " & newValue & " ..."
        isaArray.Save
        WScript.Echo "Done!" 
    End If
End Sub

Remarks

This property is read/write. Its default value is 360 minutes (6 hours), and its range of permissible values is from 1 through 99,999.

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