~~NOTOC~~
===== tn_sem_delete() =====

Функция предназначена для удаления семафора. Поле ''id_sem'' структуры ''sem'' после выполнения сервиса устанавливается в 0. Все задачи, ожидающие семафор, выйдут из сервиса ожидания с кодом возврата ''TERR_DLT''.

**Вызов:**
<code cpp>
TN_RETVAL tn_sem_delete (TN_SEM *sem);
</code>

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

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

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

  ; ''sem'' : указатель на структуру семафора типа ''TN_SEM''.  

\\ 

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

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

\\ 
**Пример вызова:**  
<code cpp>
extern TN_SEM sem_test;

tn_sem_delete(&sem_test);
</code>

\\ 

----
[[tnkernel:ref:sem:intro#Сервисы управления семафорами|К списку сервисов]]