IWTSProtocolManager::CreateListener 方法 (wtsprotocol.h)
[IWTSProtocolManager::CreateListener 已不再可供 Windows Server 2012 使用。 請改用 IWRdsProtocolManager::CreateListener。]
要求建立接聽傳入用戶端連線要求的 IWTSProtocolListener 物件。 通訊協定提供者必須先新增 IWTSProtocolListener 對象的參考,才能傳回。 當服務停止或刪除接聽程序物件時,遠端桌面服務服務會釋放參考。
語法
HRESULT CreateListener(
[in] WCHAR *wszListenerName,
[out] IWTSProtocolListener **pProtocolListener
);
參數
[in] wszListenerName
字串的指標,其中包含指定要建立的接聽程式登錄 GUID。
[out] pProtocolListener
IWTSProtocolListener 物件的指標位址。
傳回值
當您實作此方法時,如果函式成功 ,則 傳回S_OK。 如果失敗,請傳回 指出錯誤的 HRESULT 值。 如需常見錯誤碼的清單,請參閱 一般 HRESULT 值。
備註
CreateListener 方法是第一次呼叫遠端桌面服務服務對通訊協定提供者進行呼叫。 服務會在下列機碼下尋找要建立之接聽程式的 GUID 的登錄:
HKEY_LOCAL_MACHINE System CurrentControlSet Control Terminal Server WinStations ListenerName LoadableProtocol_Object
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | 都不支援 |
最低支援的伺服器 | Windows Server 2008 R2 |
目標平台 | Windows |
標頭 | wtsprotocol.h |