getCancelReason

SerwerPozostałeIdentyczna z MTA:SA

Zwraca powód podany w cancelEvent(true, powod) przez ostatnie anulowanie zdarzenia, np. powód odrzucenia połączenia w onPlayerConnect.

Składnia

string getCancelReason()

Zwraca

Powód albo pusty napis.

Przykład

addEventHandler("onPlayerConnect", root, function(nick)
    if nick:find("admin") then cancelEvent(true, "Zakazany nick") end
end)
addEventHandler("onPlayerConnect", root, function()
    if wasEventCancelled() then outputServerLog("Odrzucono: " .. getCancelReason()) end
end)

Zobacz też

cancelEventAnuluje bieżące zdarzenie z wnętrza jego obsługi. Dla zdarzeń, które na to pozwalają, blokuje domyślne działanie, np. onPlayerChat (wiadomość nie pojawi się na czacie), onPickupHit (pickup nie zostanie zebrany), onVehicleStartEnter (gracz nie wsiądzie). Pozostałe obsługi nadal się wywołują i mogą sprawdzić stan przez wasEventCancelled. Na serwerze można podać powód, który odczyta getCancelReason.
wasEventCancelledSprawdza, czy bieżące zdarzenie zostało anulowane przez cancelEvent we wcześniejszej obsłudze; poza zdarzeniem - czy ostatnie zdarzenie zostało anulowane.