WTSCreateListenerA 函式 （wtsapi32.h）
建立新的遠端桌面服務接聽程式，或設定現有的接聽程式。
語法
BOOL WTSCreateListenerA(
[in] HANDLE hServer,
[in] PVOID pReserved,
[in] DWORD Reserved,
[in] LPSTR pListenerName,
[in] PWTSLISTENERCONFIGA pBuffer,
[in] DWORD flag
);
參數
[in] hServer
RD 工作階段主機伺服器的句柄。 一律將此參數設定為 WTS_CURRENT_SERVER_HANDLE。
[in] pReserved
這個參數是保留的。 一律將此參數設定為 NULL。
[in] Reserved
這個參數是保留的。 一律將此參數設定為零。
[in] pListenerName
Null 終止字串的指標，其中包含要建立或設定之接聽程式的名稱。
[in] pBuffer
WTSLISTENERCONFIG 結構的指標，其中包含接聽程式的組態資訊。
[in] flag
呼叫的目的。 此參數可以是下列其中一個值。
WTS_LISTENER_CREATE（1（0x1））
建立新的接聽程式。
WTS_LISTENER_UPDATE （16 （0x10））
更新現有接聽程序的設定。
傳回值
如果函式成功，則傳回值是非零值。
如果函式失敗，傳回值為零。 若要取得擴充的錯誤資訊，請呼叫 getLastError 函式
言論
此函式會建立或設定使用 遠端桌面通訊協定 （RDP） 的接聽程式。 一律將 WTSLISTENERCONFIG 結構 版本 成員，pBuffer 參數所指向。
此函式不會建立或設定接聽程式的安全性描述元。 當您呼叫此函式來建立新的接聽程式時，函式會將預設的安全性描述元指派給新的接聽程式。 若要修改安全性描述元，請呼叫 WTSSetListenerSecurity 函式。 如需安全性描述項的詳細資訊，請參閱 SECURITY_DESCRIPTOR。
此函式不會驗證新接聽程序的設定。 在呼叫此函式之前，請確定這些設定有效。
注意
wtsapi32.h 標頭會根據 UNICODE 預處理器常數的定義，將 WTSCreateListener 定義為自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。 如需詳細資訊，請參閱函式原型的
要求
| 要求 | 價值 |
|---|---|
| 最低支援的用戶端 | Windows 7 |
| 支援的最低伺服器 | Windows Server 2008 R2 |
| 目標平臺 | 窗戶 |
| 標頭 | wtsapi32.h |
| 連結庫 | Wtsapi32.lib |
| DLL | Wtsapi32.dll |