WTSSetListenerSecurityW-Funktion (wtsapi32.h)
Konfiguriert den Sicherheitsdeskriptor eines Remotedesktopdienste-Listeners.
Syntax
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
Anmerkung
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 |