ITaskService：：Connect 方法 (taskschd.h)

  • 發行項

連線到遠端電腦，並將此介面上的所有後續呼叫與遠端會話產生關聯。 如果 serverName 參數是空的，這個方法將會在本機電腦上執行。 如果未指定 使用者 ，則會使用目前的權杖。

語法

HRESULT Connect(
  [in, optional] VARIANT serverName,
  [in, optional] VARIANT user,
  [in, optional] VARIANT domain,
  [in, optional] VARIANT password
);

參數

[in, optional] serverName

您要連線的電腦名稱稱。 如果 serverName 參數是空的，這個方法將會在本機電腦上執行。

[in, optional] user

連接電腦期間所使用的使用者名稱。 如果未指定 使用者 ，則會使用目前的權杖。

[in, optional] domain

使用者 參數中指定的 使用者網域。

[in, optional] password

用來連線到電腦的密碼。 如果未指定使用者名稱和密碼，則會使用目前的權杖。

傳回值

這個方法可以傳回其中一個值。

傳回碼/值 描述
S_OK
0
 作業已成功完成。
E_ACCESS_DENIED
0x80070005
 拒絕存取以連線到工作排程器服務。
SCHED_E_SERVICE_NOT_RUNNING
0x80041315
 工作排程器服務未執行。
E_OUTOFMEMORY
0x8007000e
 應用程式沒有足夠的記憶體來完成作業，或 使用者、 密碼或 網域 至少有一個 Null 和一個非 Null 值。
ERROR_BAD_NETPATH
53
 在下列情況下會傳回此錯誤：
  • serverName參數中指定的電腦名稱稱不存在。
  • 當您嘗試連線到 Windows Server 2003 或 Windows XP 電腦時，遠端電腦未啟用檔案和印表機共用防火牆例外狀況，或遠端登入服務未執行。
  • 當您嘗試連線到 Windows Vista 電腦，而遠端電腦未啟用遠端排程工作管理防火牆例外狀況，且已啟用檔案和印表機共用防火牆例外狀況，或遠端登入服務未執行時。
ERROR_NOT_SUPPORTED
50
 從 Windows Vista 電腦連線到遠端 Windows XP 或 Windows Server 2003 電腦時，無法指定 使用者、 密碼或 網域 參數。

備註

呼叫任何其他ITaskService方法之前，應該先呼叫ITaskService：：Connect方法。

如果您要從 Windows Vista 連線到遠端 Windows Vista 電腦，您必須允許遠端電腦上的遠端排程工作管理防火牆例外狀況。 若要允許此例外狀況，請按一下[開始]、[主控台]、[安全性]、[允許透過 Windows 防火牆的程式]，然後選取 [遠端排程工作管理] 核取方塊。 然後按一下 [Windows 防火牆設定] 對話方塊中的 [ 確定 ] 按鈕。

如果您是從 Windows Vista 電腦連線到遠端 Windows XP 或 Windows Server 2003 電腦，則需要允許遠端電腦上的 [檔案及印表機共用] 防火牆例外。 若要允許此例外狀況，請按一下[開始]，主控台按兩下[Windows 防火牆]，選取 [例外狀況] 索引標籤，然後選取 [檔案] 和 [印表機共用] 防火牆例外狀況。 然後按一下 [Windows 防火牆] 對話方塊中的 [ 確定 ] 按鈕。 遠端登入服務也必須在遠端電腦上執行。

注意 如果目前電腦不支援遠端工作的架構， ITaskService：：Connect 可能會在讀取工作定義時傳回錯誤 SCHED_E_INVALIDVALUE 。 若要確認目前電腦支援的最高架構版本，請檢查 ITaskService：：HighestVersion 屬性。
 

規格需求

   
最低支援的用戶端 Windows Vista [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2008 [僅限傳統型應用程式]
目標平台 Windows
標頭 taskschd.h
程式庫 Taskschd.lib
Dll Taskschd.dll

另請參閱

ITaskService

ITaskService：：HighestVersion