# NMS_GR303DestroyInterface

Destroys all connections for HDLC instances associated with a specified interface.

#### Prototype

NMS_GR303_RESULT_T NMS_GR303DestroyInterface ( NMS_GR303_INTERFACE_ID_T interfaceId)

Argument | Description
interfaceId | Interface ID of a provisioned interface.

#### Return values

Return value | Description
NMSGR303_SUCCESS |
NMSGR303_INTERNAL_FAILURE | Internal failure. Refer to the trace log for more information.
NMSGR303_INVALID_INTERFACE_ID | Specified interface is not provisioned.
NMSGR303_NOT_INITIALIZED | NMS GR303 library was not initialized with NMS_GR303Initialize.

#### Details

NMS_GR303DestroyInterface:

- Destroys the HDLC channels provisioned on the interface.

- Resets the signaling mode to CAS on timeslots occupied by disconnected HDLC channels.

- Clears the internal structures allocated for the specified interface.

Stop the interface with NMS_GR303StopInterface before calling NMS_GR303DestroyInterface, and call NMS_GR303DestroyInterface before re-provisioning the interface with NMS_GR303ProvisionInterface.

#### See also

NMS_GR303Exit

#### Example

void DestroyInterface( void )
{
NMS_GR303_RESULT_TNmsResult;
DWORD InterfaceId;
printf("NMS_GR303DestroyInterface:\n");
/* Get parameters */
promptdw_nodft("Enter interfaceId", &InterfaceId);
NmsResult = NMS_GR303DestroyInterface( InterfaceId );
printf ("NMS_GR303DestroyInterface:Result=%s\n",PRINT_RESULT(NmsResult));
}