Share via


RefreshRate Property of the IFPCConnectivityVerifiers Interface

The RefreshRate property gets or sets the time, in seconds, that the connectivity verifiers wait before rechecking connectivity.

C++

HRESULT put_RefreshRate(
    long lRefreshRate
);
HRESULT get_RefreshRate(
    long* plRefreshRate
);

Parameters

  • lRefreshRate
    A 32-bit integer that specifies the time, in seconds, that the connectivity verifiers wait before rechecking connectivity.

  • plRefreshRate
    Pointer to a variable that on return receives a 32-bit integer specifying the time, in seconds, that the connectivity verifiers wait before rechecking connectivity.

Return Value

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

Visual Basic

Property RefreshRate As Long

Property Value

A 32-bit integer that specifies the time, in seconds, that the connectivity verifiers wait before rechecking connectivity.

Example Code

This VBScript subprocedure changes the value of the RefreshRate property to the new value provided if necessary. This example does not include error handling.


Sub SetConnectivityRefreshRate(newValue)
    'Declare the objects needed.
    Dim root       ' The FPCLib.FPC root object
    Dim isaArray   ' An FPCArray object
    Dim verifiers  ' An FPCConnectivityVerifiers collection
    ' Create the root object.
    Set root = CreateObject("FPC.Root")
    ' Get references to the array object
    ' and the connectivity verifiers collection.
    Set isaArray = root.GetContainingArray()
    Set verifiers = isaArray.ConnectivityVerifiers
    ' Change the value of the property if necessary.
    WScript.Echo "Current refresh time: " & verifiers.RefreshRate
    If newValue <> verifiers.RefreshRate Then
        WScript.Echo "Setting the refresh time to " & newValue & "..."
        verifiers.RefreshRate = newValue
        verifiers.Save
        WScript.Echo "Done!"
    End If
End Sub

Remarks

This property is read/write. It is initially set to 30, and its range of permissible values is from 15 through 1,440.

This property cannot be accessed through Forefront TMG Management.

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.

See Also

FPCConnectivityVerifiers

Send comments about this topic to Microsoft

Build date: 6/30/2010