Subroutine reltimerid

Zweck

Gibt einen zuvor zugeordneten Intervallzeitgeber frei.

Bibliothek

Standard-C-Bibliothek (libc.a)

Syntax

#include <sys/time.h>
#include <sys/events.h>

int reltimerid ( TimerID)
timer_t TimerID;

Beschreibung

Die Subroutine Reltimerid wird verwendet, um einen zuvor zugeordneten Intervallzeitgeber freizugeben, der von der Subroutine Gettimerid zurückgegeben wird. Jedes anstehende Zeitgeberereignis, das von diesem Intervallzeitgeber generiert wird, wird abgebrochen, wenn der Aufruf zurückgegeben wird.

Parameter

Element Beschreibung
TimerID Gibt die ID des Intervallzeitgebers an, der freigegeben wird

Rückgabewerte

Die Subroutine Reltimerid gibt eine 0 zurück, wenn sie erfolgreich ist. Wenn ein Fehler auftritt, wird der Wert -1 zurückgegeben und errno gesetzt.

Fehlercodes

Wenn das Unterprogramm reltimerid fehlschlägt, wird -1 zurückgegeben und errno mit dem folgenden Fehlercode gesetzt:

Element Beschreibung
EINVAL Die im Parameter Timerid angegebene Zeitgeber-ID ist keine gültige Zeitgeber-ID.