UnregisterHelperObject()

FUNKTION

int UnregisterHelperObject(object helper, int type);

DEFINIERT IN

/std/living/helpers.c

ARGUMENTE

object helper
  Das Objekt, das als Hilfsobjekt deregistriert werden soll.
int type
  Helfertyp, einer der in /sys/living/helpers.h definierten Typen:
  - HELPER_TYPE_AERIAL fuer die Flug-/Segelunterstuetzung
  - HELPER_TYPE_AQUATIC fuer Tauchunterstuetzung

BESCHREIBUNG

Das als Hilfsobjekt fuer bestimmte Aktivitaeten wie zum Beispiel Tauchen
oder Fliegen bei einem Lebewesen registrierte Objekt "helper" meldet
sich bei diesem ab.
Hinweis: fuer eine temporaer gueltige "Nicht-Zustaendigkeit" kaeme auch
in Frage, in dieser Zeit einfach "0" zurueckzugeben, statt sich
komplett abzumelden.

RUECKGABEWERTE

 1  Objekt wurde erfolgreich ausgetragen (HELPER_SUCCESS)
-1  angegebenes Hilfsobjekt existiert nicht (HELPER_NO_CALLBACK_OBJECT)
-3  angegebenes Hilfsobjekt war gar nicht angemeldet
    (HELPER_NOTHING_TO_UNREGISTER)

BEISPIEL

Eine luftgefuellte Blase hatte sich als Tauch-Helfer am Spieler
angemeldet, ist jetzt aber verbraucht und meldet sich daher ab:

// Austragen im Spielerobjekt
void BlaseAustragen() {
  [...]
  if ( TP->UnregisterHelperObject(ME, HELPER_TYPE_AQUATIC)
       == HELPER_SUCCESS )
    remove();
}

SIEHE AUCH

Funktionen:  RegisterHelperObject()
Properties:  P_HELPER_OBJECTS, P_AERIAL_HELPERS, P_AQUATIC_HELPERS
Sonstiges:   /sys/living/helpers.h

19.02.2013 Arathorn