Destroys both active and standby variants of a specified interface.
NMS_V5_RESULT_T NMS_V5DestroyInterface ( NMS_V5_INTERFACE_ID_T interfaceId)
|
Argument |
Description |
|
interfaceId |
Interface ID of a provisioned interface. |
|
Return value |
Description |
|
NMSV5_SUCCESS |
|
|
NMSV5_INTERNAL_FAILURE |
Internal failure. Refer to the trace log for more information. |
|
NMSV5_INVALID_INTERFACE_ID |
Specified interface is not provisioned. |
|
NMSV5_NOT_INITIALIZED |
NMS V5 library was not initialized with NMS_V5Initialize. |
NMS_V5DestroyInterface internally destroys all on-board connections for the HDLC channels and E1 links associated with the active variant, and clears any internal structures allocated for the specified interface for both active and standby variants.
Applications must stop the interface (with NMS_V5StopInterface) before invoking NMS_V5DestroyInterface, and must invoke NMS_V5DestroyInterface before re-provisioning the interface with NMS_V5ProvisionInterface.
void DestroyInterface( void )
{
NMS_V5_RESULT_TNmsResult;
DWORD InterfaceId;
printf("NMS_V5DestroyInterface:\n");
/* Get parameters */
promptdw_nodft("Enter InterfaceId", &InterfaceId);
NmsResult = NMS_V5DestroyInterface( InterfaceId );
printf ("NMS_V5DestroyInterface:
Result=%s\n",PRINT_RESULT(NmsResult));
}