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 パラメーターの両方にジョブの識別子を指定します。
要件
| サポートされている最小のクライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | lmat.h (Lmat.h を含む) |
| Library | Netapi32.lib |
| [DLL] | Netapi32.dll |