NetScheduleJobGetInfo 関数 (lmat.h)

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

]

NetScheduleJobGetInfo 関数は、指定したコンピューターでキューに登録されている特定のジョブに関する情報を取得します。 この関数では、スケジュール サービスを開始する必要があります。

構文

NET_API_STATUS NET_API_FUNCTION NetScheduleJobGetInfo(
  [in, optional] LPCWSTR Servername,
  [in]           DWORD   JobId,
  [out]          LPBYTE  *PointerToBuffer
);

パラメーター

[in, optional] Servername

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

[in] JobId

情報を取得するジョブの識別子を示す 値。

[out] PointerToBuffer

指定したジョブを記述する AT_INFO 構造体を受け取るバッファーへのポインター。 このバッファーはシステムによって割り当てられ、 NetApiBufferFree 関数を使用して解放する必要があります。 詳細については、「 ネットワーク管理機能バッファー 」および「 ネットワーク管理機能バッファーの長さ」を参照してください。

戻り値

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

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

解説

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

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

HKLM\System\CurrentControlSet\Control\Lsa\SubmitControl

要件

関連項目

AT_INFO

NetScheduleJobAdd

NetScheduleJobDel

NetScheduleJobEnum

ネットワーク管理機能

ネットワーク管理の概要

スケジュール関数