Switches the interface to a specified standby variant.

NMS_V5_RESULT_T NMS_V5SwitchOverVariantData
(NMS_GR303_INTERFACE_ID_T interfaceId)

interfaceId Interface ID of a provisioned interface.

• NMSV5_SUCCESS
• NMSV5_NOT_INITIALIZED
  The library has not been initialized with NMS_V5Intialize.
• NMSV5_NO_STANDBY
  No standby variant is provisioned for the interface.
• NMSV5_INTERNAL_FAILURE
  Internal failure. Refer to the trace log for more information.
• NMSV5_INVALID_INTERFACE_ID
  The specified interface is not provisioned.

None.

This function stops an interface (if the interface is started), destroys the active variant connections and configurations, and configures the standby variant as active. No standby variant is defined on the interface after the switchover process finishes. Applications should then call NMS_V5StartInterface to start the interface. The application must provision the standby variant (with NMS_V5ProvisionStandByVariant) before initiating a switchover.

If a failure occurs during any stage of the switchover process, both active and standby variants are destroyed and the application must destroy and reprovision the entire interface.

NMS_V5ProvisionInterface, NMS_V5ProvisionStandByVariant, NMS_V5DestroyStandByVariant

void  SwitchOverVariantData( void )
{
 NMS_V5_RESULT_T     NmsResult;
 DWORD     InterfaceId;

 printf("NMS_V5SwitchOverVariantData:\n");

 /* Get parameters */
 promptdw_nodft("Enter interfaceId", &InterfaceId);

 NmsResult = NMS_V5SwitchOverVariantData( InterfaceId );

        printf ("NMS_V5SwitchOverVariantData:
                 Result=%s\n",PRINT_RESULT(NmsResult));
}