Auf Englisch lesen

Teilen über

WTSSetListenerSecurityW-Funktion (wtsapi32.h)

  • Artikel

Konfiguriert den Sicherheitsdeskriptor eines Remotedesktopdienste-Listeners.

Syntax

C++ 
BOOL WTSSetListenerSecurityW(
  [in] HANDLE               hServer,
  [in] PVOID                pReserved,
  [in] DWORD                Reserved,
  [in] LPWSTR               pListenerName,
  [in] SECURITY_INFORMATION SecurityInformation,
  [in] PSECURITY_DESCRIPTOR pSecurityDescriptor
);

Parameter

[in] hServer

Ein Handle zu einem RD-Sitzungshostserver. Legen Sie diesen Parameter immer auf WTS_CURRENT_SERVER_HANDLEfest.

[in] pReserved

Dieser Parameter ist reserviert. Legen Sie diesen Parameter immer auf NULL-fest.

[in] Reserved

Dieser Parameter ist reserviert. Legen Sie diesen Parameter immer auf Null fest.

[in] pListenerName

Ein Zeiger auf eine mit Null beendete Zeichenfolge, die den Namen des Listeners enthält.

[in] SecurityInformation

Ein SECURITY_INFORMATION Wert, der die festzulegenden Sicherheitsinformationen angibt. Aktivieren Sie immer die kennzeichnungen DACL_SECURITY_INFORMATION und SACL_SECURITY_INFORMATION.

Weitere Informationen zu möglichen Werten finden Sie unter SECURITY_INFORMATION.

[in] pSecurityDescriptor

Ein Zeiger auf eine SECURITY_DESCRIPTOR Struktur, die die Sicherheitsinformationen enthält, die dem Listener zugeordnet sind. Weitere Informationen zu möglichen Werten finden Sie unter SECURITY_DESCRIPTOR. Informationen zu STANDARD_RIGHTS_REQUIREDfinden Sie unter Standardzugriffsrechte.

Die diskretionäre Zugriffssteuerungsliste (DACL) des Sicherheitsdeskriptors kann einen oder mehrere der folgenden Werte enthalten.

WTS_SECURITY_ALL_ACCESS

Kombiniert diese Werte:

  • 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))

Das Recht, eine Verbindung herzustellen.

WTS_SECURITY_CURRENT_GUEST_ACCESS

Kombiniert diese Werte:

  • WTS_SECURITY_LOGOFF
  • WTS_SECURITY_VIRTUAL_CHANNELS

WTS_SECURITY_CURRENT_USER_ACCESS

Kombiniert diese Werte:

  • WTS_SECURITY_DISCONNECT
  • WTS_SECURITY_LOGOFF
  • WTS_SECURITY_RESET
  • WTS_SECURITY_SET_INFORMATION
  • WTS_SECURITY_VIRTUAL_CHANNELS

WTS_SECURITY_DISCONNECT (512 (0x200))

Das Recht, die Verbindung zu trennen.

WTS_SECURITY_GUEST_ACCESS

Definiert als WTS_SECURITY_LOGON.

WTS_SECURITY_LOGOFF (64 (0x40))

Das Recht, sich abzumelden.

WTS_SECURITY_LOGON (32 (0x20))

Das Recht, sich anzumelden.

WTS_SECURITY_MESSAGE (128 (0x80))

Das Recht, eine Nachricht an den Benutzer zu senden.

WTS_SECURITY_QUERY_INFORMATION (1 (0x1))

Das Recht, Informationen abzufragen.

WTS_SECURITY_REMOTE_CONTROL (16 (0x10))

Das Recht zur Nutzung der Fernbedienung.

WTS_SECURITY_RESET (4 (0x4))

Das Recht, Informationen zurückzusetzen.

WTS_SECURITY_SET_INFORMATION (2 (0x2))

Das Recht zum Festlegen von Informationen.

WTS_SECURITY_USER_ACCESS

Kombiniert diese Werte:

  • WTS_SECURITY_CONNECT
  • WTS_SECURITY_CURRENT_GUEST_ACCESS
  • WTS_SECURITY_QUERY_INFORMATION

WTS_SECURITY_VIRTUAL_CHANNELS (8 (0x8))

Das Recht auf Nutzung virtueller Kanäle.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ein Wert ungleich Null.

Wenn die Funktion fehlschlägt, ist der Rückgabewert null. Rufen Sie zum Abrufen erweiterter Fehlerinformationen die GetLastError--Funktion auf.

Bemerkungen

Hinweis

Der wtsapi32.h-Header definiert WTSSetListenerSecurity als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

Anforderung Wert
mindestens unterstützte Client- Windows 7
mindestens unterstützte Server- Windows Server 2008 R2
Zielplattform- Fenster
Header- wtsapi32.h
Library Wtsapi32.lib
DLL- Wtsapi32.dll

Siehe auch

SECURITY_DESCRIPTOR

SECURITY_INFORMATION