> For the complete documentation index, see [llms.txt](https://docs.devolutions.net/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.devolutions.net/rdm/de/knowledge-base/troubleshooting-articles/rdp-session-troubleshooting.md).

# Fehlerbehebung bei RDP-Sitzungen

Wenn Sie Probleme mit RDP-Sitzungen in Remote Desktop Manager haben, gehen Sie wie folgt vor, um uns bei der Diagnose der Problemursache zu helfen:

1. Deaktivieren Sie das RDP-API-Hooking und versuchen Sie, das Problem zu reproduzieren. Wenn das Problem verschwindet, ist das RDP-API-Hooking dafür verantwortlich.
2. Aktivieren Sie das RDP-API-Hooking erneut, erzeugen Sie dann RDP-API-Hooking-Protokolldateien und senden Sie diese. Erfassen Sie idealerweise ein Erfolgs- und ein Fehlerszenario, um den Vergleich zu erleichtern.

### RDP-API-Hooking deaktivieren

[Microsoft RDP API hooking](https://github.com/Devolutions/MsRdpEx) ist in Remote Desktop Manager standardmäßig aktiviert. API-Hooking ist erforderlich, [um die Funktionalität](https://blog.devolutions.net/2022/08/extending-the-microsoft-rdp-client-with-api-hooking/) des Microsoft RDP-Clients sowohl im eingebetteten (RDP ActiveX) als auch im externen Modus (mstsc, msrdc) zu erweitern.

1. Gehen Sie in Remote Desktop Manager zu ***Datei – Einstellungen – Typen – Sitzungen – Remote-Desktop (RDP)***.
2. Setzen Sie ***API-Hooking aktivieren*** auf ***Deaktiviert***.

   <figure><img src="https://cdnweb.devolutions.net/docs/RDMW2026_2024_1.png" alt=""><figcaption></figcaption></figure>
3. Klicken Sie auf ***Speichern***.
4. Starten Sie Remote Desktop Manager neu, um die Änderungen anzuwenden.

Versuchen Sie erneut, Ihre RDP-Sitzung zu starten, und prüfen Sie, ob das Problem verschwindet.

### RDP-API-Hooking-Protokolldateien erzeugen und senden

Über die Erweiterung der Funktionen des Microsoft RDP-Clients hinaus ermöglicht das RDP-API-Hooking auch die Erzeugung von Protokollen interner RDP-Client-Ereignisse, was für die Diagnose des Problems sehr nützlich ist.

1. Gehen Sie in Remote Desktop Manager zu ***Datei – Einstellungen – Typen – Sitzungen – Remote-Desktop (RDP)***.
2. Stellen Sie sicher, dass ***API-Hooking aktivieren*** auf ***Aktiviert*** gesetzt ist, insbesondere wenn Sie es vorher deaktiviert haben.

   <figure><img src="https://cdnweb.devolutions.net/docs/RDMW2028_2024_1.png" alt=""><figcaption></figcaption></figure>
3. Setzen Sie die ***Protokollebene*** auf ***Trace***.

   <figure><img src="https://cdnweb.devolutions.net/docs/RDMW6052_2024_3.png" alt=""><figcaption></figcaption></figure>
4. Klicken Sie auf ***Speichern***.
5. Starten Sie Remote Desktop Manager neu, um die Änderungen anzuwenden.

Erfassen Sie einen Fehlerfall:

1. Starten Sie eine *einzelne* RDP-Sitzung, die von dem Problem betroffen ist, und schließen Sie dann Remote Desktop Manager.
2. Gehen Sie im Datei-Explorer zu **%LocalAppData%\MsRdpEx** oder zum benutzerdefinierten Protokollausgabepfad.
3. Kopieren Sie die Protokolldatei in ein Verzeichnis „failure“ oder benennen Sie die Protokolldatei um, sodass „failure“ im Namen enthalten ist.

Erfassen Sie einen Erfolgsfall (falls möglich):

1. Starten Sie Remote Desktop Manager, starten Sie eine *einzelne* RDP-Sitzung, die nicht von dem Problem betroffen ist, und schließen Sie dann Remote Desktop Manager
2. Gehen Sie im Datei-Explorer zu **%LocalAppData%\MsRdpEx** oder zum benutzerdefinierten Protokollausgabepfad.
3. Kopieren Sie die Protokolldatei in ein Verzeichnis „success“ oder benennen Sie die Protokolldatei um, sodass „success“ im Namen enthalten ist.

Häufig wirken sich Probleme auf den eingebetteten RDP-Modus (RDP ActiveX) anders aus als auf den externen RDP-Modus (mstsc). Wenn das bei Ihnen der Fall ist, erfassen Sie Protokolle für denselben RDP-Verbindungseintrag in beiden Modi, um den Vergleich zu erleichtern:

1. Starten Sie Remote Desktop Manager
2. Klicken Sie mit der rechten Maustaste auf den RDP-Verbindungseintrag und dann auf ***Mit Parametern öffnen -> Öffnen (eingebettet/in Registerkarte)***, um die RDP-Sitzung im eingebetteten Modus zu starten, und schließen Sie dann die Registerkarte.
3. Klicken Sie mit der rechten Maustaste auf den RDP-Verbindungseintrag und dann auf ***Mit Parametern öffnen -> Öffnen (extern)***, um die RDP-Sitzung im externen Modus zu starten, und schließen Sie dann den RDP-Client.
4. Schließen Sie Remote Desktop Manager und gehen Sie dann im Datei-Explorer zu **%LocalAppData%\MsRdpEx** oder zum benutzerdefinierten Protokollausgabepfad.
5. „MsRdpEx\_RDM.log“ entspricht dem eingebetteten Modus und „MsRdpEx\_EntryName.log“ dem externen Modus; benennen Sie sie entsprechend um.

Kontaktieren Sie unser Kundensupport-Team unter <service@devolutions.net>, um einen sicheren Link zum Hochladen der Datei zu erhalten.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.devolutions.net/rdm/de/knowledge-base/troubleshooting-articles/rdp-session-troubleshooting.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
