~~NOTOC~~




===== tn_queue_delete() =====

Функция предназначена для удаления очереди сообщений. Поле ''id_dque'' очереди ''dque'' после выполнения сервиса устанавливается в 0.

Все задачи, ожидающие сообщения или ожидающие освобождения очереди будут переведены в состояние готовности к выполнению - сервисы приема и отсылки сообщения вернут код ''TERR_DLT''.

**Вызов:**
<code cpp>
TN_RETVAL tn_queue_delete (TN_DQUE *dque);
</code>

**Разрешен вызов:** \\ 

В контексте задачи

**Параметры функции:**

  ; ''dque'' : указатель на очередь сообщений  

\\ 

**Возвращаемые значения:**  

  ; ''TERR_WRONG_PARAM'' : некорректное значение параметра ((данный код возврата возможен только в случае использования сервисов с проверкой параметров))
  ; ''TERR_NOEXS'' : попытка удаления объекта, не являющегося очередью сообщений ((данный код возврата возможен только в случае использования сервисов с проверкой параметров))
  ; ''TERR_WCONTEXT'' : вызов функции из пользовательской критической секции или из обработчика прерывания
  ; ''TERR_NO_ERR'' : успешное выполнение

\\ 
**Пример вызова:**  
<code cpp>
TN_DQUE  queue TN_DATA;

tn_queue_delete(&queue);
</code>

\\ 

----
[[tnkernel:ref:dqueue:intro#Сервисы управления очередями сообщений|К списку сервисов]]