Opis

Obsługuje wszystkie błędy z modułu HamSandwich.

Funkcja próbuje wywołać inną funkcję (jeżeli istnieje) - HamFilter(Ham:id, HamError:err, const reason[]). Zwrócenie PLUGIN_HANDLED w HamFilter chroni przed wysypaniem się pluginu (daje możliwość obsługi błędu), zwrócenie czegokolwiek innego lub brak obecności HamFilter() spowoduje zastopowanie pluginu ze statusem: Fail/Error

Składnia

__fatal_ham_error(Ham:id, HamError:err, const reason[])

Typ

Notatki

• Ham:id - id funkcji z modułu HamSandwich (np. Ham_Spawn)
• HamError:err - typ błędu (zobacz niżej)
• const reason[] - powód błędu

enum HamError
{
	HAM_OK = 0,

	HAM_INVALID_FUNC,			// Funkcja nie jest poprawna
	HAM_FUNC_NOT_CONFIGURED,	// Funkcja nie jest skonfigurowania w plikach gry (gamedata)
	HAM_FUNC_NOT_AVAILABLE,		// Funkcja nie jest dostępna w tym modzie

	HAM_ERR_END
};

Przykład

public HamFilter(Ham:id, HamError:err, const reason[])
{
    // Pomijamy nieskonfigurowany Ham_NS_AwardKill
    if (id == Ham_NS_AwardKill && err == HAM_FUNC_NOT_CONFIGURED)
    {
        return PLUGIN_HANDLED; //nie zastopuje pluginu
    }
 
    //jesli blad wystapil podczas uzywania Ham_CS_RoundRespawn to przerywamy dzialanie pluginu
    if (id == Ham_CS_RoundRespawn)
    {
        return 0; //stopujemy plugin
    }
}

Uwagi

Funkcja na ogół nie używana w pluginach.