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 | このエラーは、次の状況で返されます。
|
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 [デスクトップ アプリのみ] |
タイプ ライブラリ |
|
[DLL] |
|