共用方式為

WTSGetListenerSecurityA 函式 (wtsapi32.h)

  • 發行項

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

語法

BOOL WTSGetListenerSecurityA(
  [in]            HANDLE               hServer,
  [in]            PVOID                pReserved,
  [in]            DWORD                Reserved,
  [in]            LPSTR                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 設定為第一次呼叫所傳回的數位。

注意

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

規格需求

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

另請參閱

SECURITY_DESCRIPTOR

SECURITY_INFORMATION