ジョブ転送イベントなど、受信するイベント通知の種類を指定します。
構文
HRESULT SetNotifyFlags(
[in] ULONG Val
);
パラメーター
[in] Val
次のフラグのうち 1 つ以上を設定して、受信するイベントを識別します。
| 価値 | Meaning |
|---|---|
|
ジョブ内のすべてのファイルが転送されました。 |
|
エラーが発生しました。 |
|
イベント通知が無効になっています。 BITS は他のフラグを無視します。 |
|
ジョブが変更されました。 たとえば、プロパティ値の変更、ジョブの状態の変更、ファイルの転送の進行状況などです。 コマンド ライン通知 が指定されている場合、コマンド ライン コールバックではこのフラグは無視されます。 |
|
ジョブ内のファイルが転送されました。 コマンド ライン通知 が指定されている場合、コマンド ライン コールバックではこのフラグは無視されます。 |
|
ファイル内のバイト範囲が転送されました。 コマンド ライン通知 が指定されている場合、コマンド ライン コールバックではこのフラグは無視されます。 フラグは任意のジョブに対して指定できますが、 BITS_JOB_PROPERTY_ON_DEMAND_MODE ジョブの要件を満たすジョブについてのみ通知を受け取ります。 |
戻り値
このメソッドは、次の HRESULT 値と他の値を返します。
| リターン コード | Description |
|---|---|
|
イベント通知の種類が正常に設定されました。 |
|
NotifyFlags 値が無効です。 |
|
ジョブの状態をBG_JOB_STATE_CANCELLEDまたはBG_JOB_STATE_ACKNOWLEDGEDすることはできません。 |
注釈
イベント通知を受信するには、IBackgroundCopyJob::SetNotifyInterface メソッドと IBackgroundCopyJob2::SetNotifyCmdLine メソッドと組み合わせて SetNotifyFlags メソッドを使用します。
例示
IBackgroundCopyJob::SetNotifyInterface メソッドのコード例を参照してください。
Requirements
| Requirement | 価値 |
|---|---|
| サポートされる最小クライアント | Windows XP |
| サポートされている最小のサーバー | Windows Server 2003 |
| ターゲット プラットフォーム の | ウィンドウズ |
| Header | bits.h |
| Library | Bits.lib |
| DLL | QmgrPrxy.dll |
こちらも参照ください
IBackgroundCopyJob2::SetNotifyCmdLine