WTSConnectSessionA 函式 (wtsapi32.h)

將遠端桌面服務會話連線到本機電腦上的現有會話。

語法

BOOL WTSConnectSessionA(
  [in] ULONG LogonId,
  [in] ULONG TargetLogonId,
  [in] PSTR  pPassword,
  [in] BOOL  bWait
);

[in] LogonId

要連線之會話的登入識別碼。該會話的使用者必須具有連線到現有會話的許可權。此會話的輸出將會路由傳送至 TargetLogonId 參數所識別的會話。

這可以 LOGONID_CURRENT 使用目前的會話。

[in] TargetLogonId

要接收 LogonId 參數所表示之會話輸出之會話的登入識別碼。 LogonId參數所識別之會話的輸出將會路由傳送至此會話。

這可以 LOGONID_CURRENT 使用目前的會話。

[in] pPassword

在 LogonId參數中指定的使用者帳戶之密碼指標。如果呼叫端使用與登入識別碼相同的功能變數名稱和使用者名稱登入， pPassword 的值可以是空字串。 pPassword的值不能是Null。

[in] bWait

指出作業是否為同步。指定 TRUE 以等候作業完成，或 指定 FALSE 立即傳回。

如果函式成功，則傳回值是非零值。

如果此函式失敗，則傳回值為零。若要取得擴充的錯誤資訊，請呼叫 GetLastError。

LogonId或TargetLogonId參數都可以LOGONID_CURRENT，但不能同時同時設定兩者。

注意

wtsapi32.h 標頭會根據 UNICODE 預處理器常數的定義，將 WTSConnectSession 定義為別名，自動選取此函式的 ANSI 或 Unicode 版本。混合使用編碼中性別名與非編碼中性的程式碼，可能會導致編譯或執行時間錯誤不符。如需詳細資訊，請參閱函式原型的慣例。