共用方式為

WTSSetListenerSecurityA 函式 （wtsapi32.h）

  • 發行項

設定遠端桌面服務接聽程式的安全性描述元。

語法

BOOL WTSSetListenerSecurityA(
  [in] HANDLE               hServer,
  [in] PVOID                pReserved,
  [in] DWORD                Reserved,
  [in] LPSTR                pListenerName,
  [in] SECURITY_INFORMATION SecurityInformation,
  [in] PSECURITY_DESCRIPTOR pSecurityDescriptor
);

參數

[in] hServer

RD 工作階段主機伺服器的句柄。 一律將此參數設定為 WTS_CURRENT_SERVER_HANDLE。

[in] pReserved

這個參數是保留的。 一律將此參數設定為 NULL。

[in] Reserved

這個參數是保留的。 一律將此參數設定為零。

[in] pListenerName

包含接聽程式名稱之 Null 終止字串的指標。

[in] SecurityInformation

SECURITY_INFORMATION 值，指定要設定的安全性資訊。 一律啟用 DACL_SECURITY_INFORMATION 和 SACL_SECURITY_INFORMATION 旗標。

如需可能值的詳細資訊，請參閱 SECURITY_INFORMATION。

[in] pSecurityDescriptor

SECURITY_DESCRIPTOR 結構的指標，其中包含與接聽程式相關聯的安全性資訊。 如需可能值的詳細資訊，請參閱 SECURITY_DESCRIPTOR。 如需 STANDARD_RIGHTS_REQUIRED的相關信息，請參閱 標準存取權限。

安全性描述元的任意訪問控制清單 （DACL） 可以包含下列一或多個值。

WTS_SECURITY_ALL_ACCESS

結合這些值：

  • STANDARD_RIGHTS_REQUIRED
  • WTS_SECURITY_CONNECT
  • WTS_SECURITY_DISCONNECT
  • WTS_SECURITY_LOGON
  • WTS_SECURITY_MESSAGE
  • WTS_SECURITY_QUERY_INFORMATION
  • WTS_SECURITY_REMOTE_CONTROL
  • WTS_SECURITY_RESET
  • WTS_SECURITY_SET_INFORMATION
  • WTS_SECURITY_VIRTUAL_CHANNELS

WTS_SECURITY_CONNECT （256 （0x100））

線上許可權。

WTS_SECURITY_CURRENT_GUEST_ACCESS

結合這些值：

  • WTS_SECURITY_LOGOFF
  • WTS_SECURITY_VIRTUAL_CHANNELS

WTS_SECURITY_CURRENT_USER_ACCESS

結合這些值：

  • WTS_SECURITY_DISCONNECT
  • WTS_SECURITY_LOGOFF
  • WTS_SECURITY_RESET
  • WTS_SECURITY_SET_INFORMATION
  • WTS_SECURITY_VIRTUAL_CHANNELS

WTS_SECURITY_DISCONNECT （512 （0x200））

中斷聯機的權利。

WTS_SECURITY_GUEST_ACCESS

定義為 WTS_SECURITY_LOGON。

WTS_SECURITY_LOGOFF （64 （0x40））

註銷許可權。

WTS_SECURITY_LOGON （32 （0x20））

登入權。

WTS_SECURITY_MESSAGE （128 （0x80））

傳送訊息給用戶的權利。

WTS_SECURITY_QUERY_INFORMATION（1（0x1））

查詢信息的權利。

WTS_SECURITY_REMOTE_CONTROL （16 （0x10））

使用遠端控制的權利。

WTS_SECURITY_RESET（4（0x4））

重設信息的權利。

WTS_SECURITY_SET_INFORMATION（2（0x2））

設定信息的權利。

WTS_SECURITY_USER_ACCESS

結合這些值：

  • WTS_SECURITY_CONNECT
  • WTS_SECURITY_CURRENT_GUEST_ACCESS
  • WTS_SECURITY_QUERY_INFORMATION

WTS_SECURITY_VIRTUAL_CHANNELS（8（0x8））

使用虛擬通道的權利。

傳回值

如果函式成功，則傳回值是非零值。

如果函式失敗，傳回值為零。 若要取得擴充的錯誤資訊，請呼叫 getLastError 函式 。

言論

注意

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

要求

要求 價值
最低支援的用戶端 Windows 7
支援的最低伺服器 Windows Server 2008 R2
目標平臺 窗戶
標頭 wtsapi32.h
連結庫 Wtsapi32.lib
DLL Wtsapi32.dll

另請參閱

SECURITY_DESCRIPTOR

SECURITY_INFORMATION