共用方式為

WTSGetListenerSecurityW 函式 （wtsapi32.h）

  • 發行項

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

語法

BOOL WTSGetListenerSecurityW(
  [in]            HANDLE               hServer,
  [in]            PVOID                pReserved,
  [in]            DWORD                Reserved,
  [in]            LPWSTR               pListenerName,
  [in]            SECURITY_INFORMATION SecurityInformation,
  [out, optional] PSECURITY_DESCRIPTOR pSecurityDescriptor,
  [in]            DWORD                nLength,
  [out]           LPDWORD              lpnLengthNeeded
);

參數

[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。

[out, optional] pSecurityDescriptor

SECURITY_DESCRIPTOR 結構的指標，會接收與 pListenerName 參數所參考之接聽程式相關聯的安全性資訊。 SECURITY_DESCRIPTOR 結構會以自我相對格式傳回。 如需可能值的詳細資訊，請參閱 SECURITY_DESCRIPTOR。

安全性描述元的任意訪問控制清單 （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））

使用虛擬通道的權利。

[in] nLength

pSecurityDescriptor 參數所參考之 SECURITY_DESCRIPTOR 結構的大小，以位元組為單位。

[out] lpnLengthNeeded

變數的指標，可接收儲存完整安全性描述元所需的位元組數目。 如果這個數位小於或等於 nLength 參數的值，安全性描述元會複製到 pSecurityDescriptor 參數 所參考的 SECURITY_DESCRIPTOR 結構;否則，不會採取任何動作。

傳回值

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

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

言論

如果接收 SECURITY_DESCRIPTOR 結構之緩衝區所需的位元組數目未知，您可以使用 nLength 設為零來呼叫此方法。 方法接著會在 lpnLengthNeeded 參數中傳回緩衝區所需的位元組數目。 根據這個數位配置緩衝區，然後再次呼叫 方法，將 pSecurityDescriptor 設定為新配置的緩衝區，並將 nLength 設定為第一次呼叫所傳回的數位 nLength。

注意

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

要求

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

另請參閱

SECURITY_DESCRIPTOR

SECURITY_INFORMATION