WTSOpenServerExA 函式 (wtsapi32.h)
開啟指定遠端桌面會話主機 (RD 工作階段主機) 伺服器或遠端桌面虛擬化主機 (RD 虛擬化主機) 伺服器的句柄。
語法
HANDLE WTSOpenServerExA(
[in] LPSTR pServerName
);
參數
[in] pServerName
包含伺服器 NetBIOS 名稱之 Null 終止字串的指標。
傳回值
如果函式成功,則傳回值是指定伺服器的句柄。
如果函式失敗,它會傳回無效的句柄。 您可以在另一個函式調用中使用句柄,來測試句柄的有效性。
備註
如果 pServerName 參數指定的伺服器是 RD 工作階段主機伺服器,則此函式的行為與 WTSOpenServer 函式的行為相同。
若要使用在呼叫應用程式執行所在 RD Virtualization Host 伺服器上的虛擬機上執行的會話,請為 pServerName 參數指定WTS_CURRENT_SERVER_NAME。
當您完成使用此函式傳回的句柄時,請呼叫 WTSCloseServer 函式來釋放它。
注意
wtsapi32.h 標頭會根據 UNICODE 預處理器常數的定義,將 WTSOpenServerEx 定義為別名,自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼,可能會導致編譯或運行時間錯誤不符。 如需詳細資訊,請參閱 函式原型的慣例。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows 7 |
最低支援的伺服器 | Windows Server 2008 R2 |
目標平台 | Windows |
標頭 | wtsapi32.h |
程式庫 | Wtsapi32.lib |
Dll | Wtsapi32.dll |