SysEvent_DeferEvent関数

ヘッダー: applibs </sysevent.h #include>

指定した期間、イベントの延期を試みます。 この関数は、イベントの状態が SysEvent_Status_Pendingされている場合にのみ呼び出す必要があります。 イベントが保留中でない場合、呼び出しは失敗します。

int SysEvent_DeferEvent(SysEvent_Events event, uint32_t requested_defer_time_in_minutes);

パラメーター

• event 延期するイベントの種類。

• requested_defer_time_in_minutes 遅延の期間 (分単位)。 最大遅延時間は、OS 更新プログラムの場合は 24 時間、アプリケーションの場合は 167 時間です。 イベントで許可されている最大値より長い遅延を要求した場合、遅延は最大で切り捨てられます。

エラー

エラーが発生した場合は -1 を返し、エラー値に設定します errno 。

• EACCES: アプリケーションには、指定したイベントを延期する機能がありません。

その他 errno の動作も指定できますが、システム更新プログラムによって同じ動作が保持される保証はありません。

戻り値

成功の場合は 0、失敗の場合は -1 を返します。この場合 errno はエラー値に設定されます。

アプリケーション マニフェストの要件

アプリケーション マニフェストには、SystemEventNotifications および SoftwareUpdateDeferral 機能が含まれている必要があります。