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
要件
| サポートされている最小のクライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | lmat.h (Lmat.h を含む) |
| Library | Netapi32.lib |
| [DLL] | Netapi32.dll |