IFPCEEConfigurationStorageServerConnection::FallbackDelay property

Applies to: desktop apps only

The FallbackDelay property gets or sets the time (in minutes) after which an array member will start using the other Configuration Storage server when the current Configuration Storage server is unavailable.

This property is read/write.

Syntax

HRESULT put_FallbackDelay(
  long lFallbackDelay
);

HRESULT get_FallbackDelay(
  long *plFallbackDelay
);

' Data type: Long

Property FallbackDelay( _
  ByVal lFallbackDelay As long, _
  ByVal plFallbackDelay As long _
) As Long

Property value

A 32-bit integer that specifies the time (in minutes) after which an array member will start using the other Configuration Storage server when the current Configuration Storage server is unavailable.

Error codes

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

Remarks

This property is read/write. Its default value is 30 minutes, and its range of permissible values is from 1 through 99,999.

Examples

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 FallbackDelay property to the new value provided if necessary. This example does not include error handling.

Sub SetFallbackDelay(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.FallbackDelay
    WScript.Echo "Current fallback delay: " & currentValue
    If newValue <> currentValue Then
        cssCn.FallbackDelay = newValue
        WScript.Echo "Saving the new value " & newValue & " ..."
        isaArray.Save
        WScript.Echo "Done!" 
    End If
End Sub

Requirements

See also

FPCConfigurationStorageServerConnection

Build date: 7/12/2010