WTSOpenServerExA 函式（wtsapi32.h）

開啟指定遠端桌面工作階段主機（RD 工作階段主機）伺服器或遠端桌面虛擬化主機（RD 虛擬化主機）伺服器的句柄。

語法

HANDLE WTSOpenServerExA(
  [in] LPSTR pServerName
);

[in] pServerName

包含伺服器 NetBIOS 名稱之 Null 終止字串的指標。

如果函式成功，傳回值就是指定伺服器的句柄。

如果函式失敗，它會傳回無效的句柄。您可以在另一個函數調用中使用句柄來測試句柄的有效性。

如果 pServerName 參數所指定的伺服器是 RD 工作階段主機伺服器，則此函式的行為與 WTSOpenServer 函式的行為相同。

若要處理在呼叫應用程式執行所在的 RD 虛擬主機伺服器上執行的虛擬機上執行的工作階段，請為 pServerName 參數指定 WTS_CURRENT_SERVER_NAME。

當您完成使用此函式傳回的句柄時，請呼叫 WTSCloseServer 函式來釋放它。

注意

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