ITaskScheduler::SetTargetComputer メソッド (mstask.h)

[[この API は、以降のバージョンのオペレーティング システムまたは製品で変更または使用できない場合があります。 代わりに タスク スケジューラ 2.0 インターフェイス を使用してください。] ]

SetTargetComputer メソッドは、ITaskScheduler インターフェイスが動作するコンピューターを選択し、リモート タスクの管理と列挙を可能にします。

構文

HRESULT SetTargetComputer(
  [in] LPCWSTR pwszComputer
);

パラメーター

[in] pwszComputer

ITaskScheduler インターフェイスの現在のインスタンスのターゲット コンピューター名を指定する、null で終わるワイド文字列へのポインター。 汎用名前付け規則 (UNC) 形式でターゲット コンピューター名を指定します。 ローカル コンピューターを示すには、この値を NULL またはローカル コンピューターの UNC 名に設定します。

メモ リモート コンピューター名を指定する場合は、コンピューター名の前に 2 つの円記号 (\\) を使用します。 たとえば、"ComputerName" の代わりに "\\ComputerName" を使用します。
 

戻り値

SetTargetComputer メソッドは、次のいずれかの値を返します。

リターン コード 説明
S_OK
メソッドは正常に実行されました。
SCHED_E_SERVICE_NOT_INSTALLED
タスク スケジューラ サービスがターゲット コンピューターにインストールされていません。
E_ACCESS_DENIED
ユーザーはリモート コンピューターにアクセスできません。
E_INVALIDARG
pwszComputer パラメーターが無効です。
E_OUTOFMEMORY
メモリ割り当てエラーが発生しました。

注釈

Windows Server 2003、Windows XP コンピューターで Windows Vista コンピューターでタスクを作成、監視、または制御するには、Windows Vista コンピューターで次の操作を完了する必要があります。 また、ITaskScheduler::SetTargetComputer メソッドを呼び出すユーザーは、リモート Windows Vista コンピューターの Administrators グループのメンバーである必要があります。

Windows ファイアウォールで "ファイルとプリンターの共有" 例外を有効にする

  1. [スタート] ボタンをクリックし、[コントロール パネル] をクリックします。
  2. コントロール パネルで、[クラシック ビュー] をクリックし、[Windows ファイアウォール] アイコンをダブルクリックします。
  3. [Windows ファイアウォール] ウィンドウで、[例外] タブをクリックし、[ファイルとプリンターの共有の例外チェック] ボックスを選択します。

"リモート レジストリ" サービスを有効にする

  • コマンド プロンプト ウィンドウを開き、次のコマンドを入力します。 net start "Remote Registry"

要件

要件
サポートされている最小のクライアント Windows XP (デスクトップ アプリのみ)
サポートされている最小のサーバー Windows Server 2003 (デスクトップ アプリのみ)
対象プラットフォーム Windows
ヘッダー mstask.h
Library Mstask.lib
[DLL] Mstask.dll

こちらもご覧ください

ITaskScheduler