NetScheduleJobDel 関数 (lmat.h)

[NetScheduleJobDel は Windows 8 の時点で使用できなくなりました。 代わりに、 タスク スケジューラ 2.0 インターフェイスを使用します。

]

NetScheduleJobDel 関数は、コンピューターで実行するためにキューに登録されているジョブの範囲を削除します。 この関数では、ジョブ削除要求の送信先のコンピューターでスケジュール サービスを開始する必要があります。

構文

NET_API_STATUS NET_API_FUNCTION NetScheduleJobDel(
  [in, optional] LPCWSTR Servername,
  [in]           DWORD   MinJobId,
  [in]           DWORD   MaxJobId
);

パラメーター

[in, optional] Servername

関数を実行するリモート サーバーの DNS または NetBIOS 名を指定する定数文字列へのポインター。 このパラメーターが NULL の場合は、ローカル コンピューターが使用されます。

[in] MinJobId

最小ジョブ識別子。 MinJobId より小さいジョブ識別子を持つジョブは削除されません。

[in] MaxJobId

ジョブの最大識別子。 MaxJobId より大きいジョブ識別子を持つジョブは削除されません。

戻り値

関数が成功した場合、戻り値はNERR_Success。

関数が失敗した場合、戻り値はシステム エラー コードです。 エラー コードの一覧については、「 システム エラー コード」を参照してください。

解説

通常、スケジュール ジョブが削除されているコンピューター上のローカル Administrators グループのメンバーのみが、この関数を正常に実行できます。 Servername パラメーターが指す文字列で渡されたサーバー名がリモート サーバーの場合、サーバー上のローカル Administrators グループのメンバーのみが正常にこの関数を実行できます。

次のレジストリ値に最下位ビットが設定されている場合 (たとえば、0x00000001)、サーバーオペレーター グループに属するユーザーもこの関数を正常に実行できます。

HKLM\System\CurrentControlSet\Control\Lsa\SubmitControl

NetScheduleJobEnum 関数を呼び出して、1 つ以上のスケジュールされたジョブのジョブ識別子を取得します。

NetScheduleJobDel 関数は、ジョブ識別子が MinJobId から MaxJobId の範囲内にあるすべてのジョブを削除します。

サーバーでスケジュールされたすべてのジョブを削除するには、MinJobId を 0 に、MaxJobId を – 1 に指定して NetScheduleJobDel を呼び出します。 1 つのジョブを削除するには、 MinJobId パラメーターと MaxJobId パラメーターの両方にジョブの識別子を指定します。

要件

関連項目

NetScheduleJobAdd

NetScheduleJobEnum

NetScheduleJobGetInfo

ネットワーク管理機能

ネットワーク管理の概要

スケジュール関数