Udostępnij za pośrednictwem

Funkcja SysEvent_DeferEvent

  • Artykuł

Nagłówek: #include <applibs/sysevent.h>

Próby odroczenia zdarzenia na określony czas trwania. Ta funkcja powinna być wywoływana tylko wtedy, gdy stan zdarzenia jest SysEvent_Status_Pending. Jeśli zdarzenie nie jest oczekujące, połączenie kończy się niepowodzeniem.

int SysEvent_DeferEvent(SysEvent_Events event, uint32_t requested_defer_time_in_minutes);

Parametry

  • event Typ zdarzenia do odroczenia.

  • requested_defer_time_in_minutes Czas trwania odroczenia w minutach. Maksymalny czas odroczenia to 24 godziny dla aktualizacji systemu operacyjnego i 167 godzin dla aplikacji. Jeśli zażądasz odroczenia dłuższego niż maksymalna dozwolona dla zdarzenia, odroczenie zostanie obcięte do maksymalnej wartości.

Błędy

Zwraca wartość -1 w przypadku napotkania błędu i ustawia errno wartość błędu.

  • EACCES: Aplikacja nie ma możliwości odroczenia określonego zdarzenia.

errno Inne mogą być również określone, ale nie ma gwarancji, że to samo zachowanie zostanie zachowane za pośrednictwem aktualizacji systemu.

Zwracana wartość

Zwraca wartość 0 dla powodzenia lub -1 dla niepowodzenia, w którym to przypadku errno jest ustawiona wartość błędu.

Wymagania dotyczące manifestu aplikacji

Manifest aplikacji musi zawierać funkcje SystemEventNotifications i SoftwareUpdateDeferral.