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，但不能同時 LOGONID_CURRENT。

注意

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