WTSOpenServerA 函式 (wtsapi32.h)

  • 發行項

開啟指定遠端桌面會話主機的句柄， (RD 工作階段主機) 伺服器。

語法

HANDLE WTSOpenServerA(
  [in] LPSTR pServerName
);

參數

[in] pServerName

指定 RD 工作階段主機伺服器的 NetBIOS 名稱之 Null 終止字串的指標。

傳回值

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

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

備註

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

您不需要開啟在應用程式執行所在 RD 工作階段主機伺服器上執行的作業句柄。 請改用常數 WTS_CURRENT_SERVER_HANDLE 。

注意

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

規格需求

需求 值
最低支援的用戶端 Windows Vista
最低支援的伺服器 Windows Server 2008
目標平台 Windows
標頭 wtsapi32.h
程式庫 Wtsapi32.lib
Dll Wtsapi32.dll

另請參閱

WTSCloseServer