TaskService.Connect メソッド

スクリプトの場合は、リモート コンピューターに接続し、このインターフェイスの後続のすべての呼び出しをリモート セッションに関連付けます。 serverName パラメーターが空の場合、このメソッドはローカル コンピューターで実行されます。 userId が指定されていない場合は、現在のトークンが使用されます。

構文

TaskService.Connect( _
  [ ByVal serverName ], _
  [ ByVal user ], _
  [ ByVal domain ], _
  [ ByVal password ] _
)

パラメーター

serverName [in, optional]

接続するコンピューターの名前。 serverName パラメーターが空の場合、このメソッドはローカル コンピューターで実行されます。

user [in, optional]

コンピューターへの接続中に使用されるユーザー名。 ユーザーが指定されていない場合は、現在のトークンが使用されます。

domain [in, optional]

user パラメーターで指定された ユーザー のドメイン。

password [in, optional]

コンピューターへの接続に使用されるパスワード。 ユーザー名とパスワードが指定されていない場合は、現在のトークンが使用されます。

戻り値

このメソッドは値を返しません。

解説

TaskService.Connect メソッドは、他の TaskService メソッドを呼び出す前に呼び出す必要があります。

Connect メソッドが失敗した場合は、エラー識別子を収集して、エラーの意味を見つけることができます。 次の表に、エラー識別子とその説明を示します。

エラー識別子 説明
0x80070005 タスク スケジューラ サービスに接続するためにアクセスが拒否されました。
0x80041315 タスク スケジューラ サービスが実行されていません。
0x8007000e アプリケーションに操作を完了するための十分なメモリが不足しているか、 ユーザーパスワード、または ドメイン に少なくとも 1 つの null 値と 1 つの null 以外の値があります。
53 このエラーは、次の状況で返されます。
  • serverName パラメーターで指定されたコンピューター名が存在しません。
  • Windows Server 2003 または Windows XP コンピューターに接続しようとしたときに、リモート コンピューターでファイルとプリンターの共有ファイアウォールの例外が有効になっていないか、リモート レジストリ サービスが実行されていません。
  • Windows Vista コンピューターに接続しようとしているときに、リモート コンピューターでリモート スケジュールされたタスク管理ファイアウォールの例外が有効になっていない場合、およびファイルとプリンターの共有ファイアウォールの例外が有効になっている場合、またはリモート レジストリ サービスが実行されていません。
50 Windows Vista コンピューターからリモート Windows XP または Windows Server 2003 コンピューターに接続する場合、 ユーザーパスワード、または ドメイン のパラメーターを指定することはできません。

Windows Vista からリモート Windows Vista コンピューターに接続する場合は、リモート コンピューターでリモート スケジュールタスク管理ファイアウォールの例外を許可する必要があります。 この例外を許可するには、[スタート]、[コントロール パネル、[セキュリティ]、[Windows ファイアウォール経由でプログラムを許可する] の順にクリックし、[リモート スケジュールされたタスク管理] チェック ボックスを選択します。 その後、[ Windows ファイアウォールの設定 ] ダイアログ ボックスの [ OK ] をクリックします。

Windows Vista コンピューターからリモートの Windows XP または Windows Server 2003 コンピューターに接続する場合、リモート コンピューター上でファイアウォールの例外 [ ファイルとプリンターの共有 ] を許可する必要があります。 この例外を許可するには、[スタート]、[コントロール パネル]、[Windows ファイアウォール] の順にダブルクリックし、[例外] タブを選択し、[ファイルとプリンターの共有] ファイアウォールの例外を選択します。 次に、[Windows ファイアウォール] ダイアログ ボックスの [OK] ボタンをクリックします。 リモート レジストリ サービスは、リモート コンピューターでも実行されている必要があります。

必要条件

要件
サポートされている最小のクライアント
Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー
Windows Server 2008 [デスクトップ アプリのみ]
タイプ ライブラリ
Taskschd.tlb
[DLL]
Taskschd.dll