SEMA_DELETE

Elimina (destrói) o semáforo identificado por HANDLE, liberando o recurso associado, e retorna um código de status da operação. É uma função.

Biblioteca: HI_STD · Namespace: HILS · Tipo: função

Função

          SEMA_DELETE
        +--------------+
DINT ---|HANDLE        |--- UINT
        +--------------+

Recebe em HANDLE o identificador do semáforo previamente criado por SEMA_CREATE e o elimina. O valor de retorno (UINT) indica o status da eliminação.

Cuidado

Nunca elimine um semáforo quando existir uma tarefa aguardando por ele.

Parâmetros

Nome	Direção	Tipo	Padrão	Faixa / Unidade	Descrição
HANDLE	IN	DINT	—	—	Handle do semáforo obtido na criação (ver SEMA_CREATE).

Retorno / Saídas

A função retorna um UINT com o status da operação: 0 = eliminação concluída com sucesso; valor diferente de 0 indica falha.

Pré-condições

• HANDLE deve corresponder a um semáforo válido, criado por SEMA_CREATE.

• Nenhuma tarefa pode estar aguardando pelo semáforo no momento da eliminação.

Ver também

SEMA_CREATE, SEMA_SIGNAL, SEMA_WAIT