> 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/it/knowledge-base/knowledge-base-articles/microsoft-rdp-api-hooking.md).

# Hooking dell'API RDP di Microsoft

Abiliti l'API hooking di Microsoft RDP in Remote Desktop Manager per estendere le funzionalità del client RDP e risolvere i problemi di Kerberos e dei certificati TLS.

L'API hooking di Microsoft RDP è disponibile e abilitato per impostazione predefinita in Remote Desktop Manager. L'API hooking è necessario per estendere le funzionalità del client Microsoft RDP sia in modalità incorporata (ActiveX) sia in modalità esterna (mstsc).

Se lo ha disabilitato, può abilitarlo nuovamente andando in Remote Desktop Manager ***File – Impostazioni – Tipi – Sessioni – Desktop remoto (RDP) – API hooking*** e impostando ***Enable API hooking*** su ***Enabled*** o ***Default***.

Riavvii Remote Desktop Manager per applicare la modifica.

{% hint style="info" %}
Il criterio EnableRDPHooking ha la precedenza sull'impostazione ***Enable API hooking***. Se non è configurato (nessuna chiave di registro), verrà utilizzato il valore dell'opzione di Remote Desktop Manager. Un valore pari a "0" indica che l'hooking RDP è disabilitato, mentre un valore diverso da "0" indica che l'hooking RDP è abilitato. Ciò consente all'amministratore di forzare una delle due impostazioni oppure di lasciare effettiva la configurazione locale. Veda tutti i criteri, incluso questo, in [Applicare i criteri](/rdm/it/knowledge-base/how-to-articles/apply-policies-gpos.md).
{% endhint %}

Il modulo di API hooking di Microsoft RDP verrà caricato alla prima connessione Microsoft RDP. Nell'improbabile caso in cui noti instabilità con l'API hooking abilitato, lo disabiliti e contatti il [team di assistenza clienti](mailto:service@devolutions.net) per segnalare il problema.

### Registrazione dei log di Microsoft RDP

L'API hooking di Microsoft RDP consente di registrare eventi e opzioni interni che in precedenza non era possibile registrare. Se riscontra problemi, vada in ***File – Impostazioni – Tipi – Desktop remoto – API hooking*** e imposti il ***Log level*** su ***Debug***. Riavvii Remote Desktop Manager per ottenere i file di log in **%LocalAppData%\MsRdpEx**, che potrà poi inviare al [team di assistenza clienti](mailto:service@devolutions.net) per aiutare a diagnosticare i problemi.

### Devolutions Gateway

L'API hooking di Microsoft RDP dovrebbe essere abilitato per le connessioni Devolutions Gateway, poiché corregge il nome del server utilizzato per la convalida da parte del client RDP. Questo può risolvere il problema della mancata corrispondenza del nome Kerberos, ma può anche correggere la convalida del certificato TLS. Ciò è particolarmente importante per i clienti che utilizzano l'opzione ***Force using IP address for RDP connections***, poiché risolve il problema alla radice:

Una volta abilitato l'API hooking di Microsoft RDP, l'opzione ***Force using IP address for RDP connections*** dovrebbe essere disabilitata. Nei casi in cui si verificava il problema di mancata corrispondenza del nome Kerberos, Kerberos dovrebbe ora funzionare correttamente.

### GPO delle credenziali aggiornate RDP

L'API hooking di RDP risolve il problema per cui il criterio di gruppo RDP ***Always prompt for password upon connection*** impedisce l'iniezione delle credenziali da Remote Desktop Manager. Questo criterio di gruppo ha lo scopo di forzare **mstsc.exe** a richiedere credenziali aggiornate a ogni connessione, ma ha l'effetto collaterale indesiderato di interrompere l'iniezione delle credenziali. Tramite l'API hooking viene applicata una soluzione alternativa per farla funzionare.


---

# 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/it/knowledge-base/knowledge-base-articles/microsoft-rdp-api-hooking.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.
