WTSGetListenerSecurityA-Funktion (wtsapi32.h)
Ruft den Sicherheitsdeskriptor eines Remotedesktopdienste-Listeners ab.
Syntax
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
);
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 abzurufenden 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.
[out, optional] pSecurityDescriptor
Ein Zeiger auf eine SECURITY_DESCRIPTOR Struktur, die die Sicherheitsinformationen empfängt, die dem Listener zugeordnet sind, auf den der pListenerName Parameter verweist. Die SECURITY_DESCRIPTOR Struktur wird im selbstrelativen Format zurückgegeben. Weitere Informationen zu möglichen Werten finden Sie unter SECURITY_DESCRIPTOR.
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.
[in] nLength
Die Größe der SECURITY_DESCRIPTOR Struktur, auf die durch den pSecurityDescriptor Parameter verwiesen wird.
[out] lpnLengthNeeded
Ein Zeiger auf eine Variable, die die Anzahl der Bytes empfängt, die zum Speichern des vollständigen Sicherheitsdeskriptors erforderlich sind. Wenn diese Zahl kleiner oder gleich dem Wert des nLength Parameters ist, wird der Sicherheitsdeskriptor in die SECURITY_DESCRIPTOR Struktur kopiert, auf die durch den pSecurityDescriptor Parameter verwiesen wird; andernfalls wird keine Aktion ausgeführt.
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
Wenn die Anzahl der Bytes für den Puffer, der die SECURITY_DESCRIPTOR Struktur empfängt, unbekannt ist, können Sie diese Methode aufrufen, wobei nLength auf Null festgelegt ist. Die Methode gibt dann in der lpnLengthNeeded Parameter die Anzahl der für den Puffer erforderlichen Bytes zurück. Weisen Sie den Puffer basierend auf dieser Nummer zu, und rufen Sie dann die Methode erneut auf, und legen Sie pSecurityDescriptor auf den neu zugewiesenen Puffer fest und nLength auf die nummer, die vom ersten Aufruf zurückgegeben wird.
Anmerkung
Der wtsapi32.h-Header definiert WTSGetListenerSecurity 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 |