Understand Citrix CtxHook interaction with Cloud Drive Mapper (CDM)

When you deploy CDM to a Citrix virtual desktop environment, the CDM installer interacts with CtxHook. CtxHook is a Citrix component that plays a critical role in enhancing and modifying the behavior of applications running within Citrix environments. This interaction allows Citrix to intercept and modify specific system calls made by CDM to ensure a seamless user experience without the need for manual intervention. It entails the following:

• The CDM installer integrates seamlessly with CtxHook to ensure that you have complete control over it.

• The CDM installer appends an entry to the CtxHook registry key that allows msedgewebview2.exe to run if necessary. The CDM installer does this to negate Citrix API hooks from preventing Microsoft Edge WebView2 from running correctly. Which, in turn, could prevent CDM from authenticating.

• The CDM installer does not alter existing CtxHook registry values as we recognize the significance of these values for other applications' stability and seamless operation.

• When the CDM installer detects that an entry to allow msedgewebview2.exe to run already exists in the CtxHook registry key, it does not append it again to avoid redundancy or overwriting the existing entry.

This interaction of the CDM installer with CtxHook is specific to Citrix virtual desktop environments running on Windows Server 2019, 2022, and 2025. Please ensure compliance with these requirements before deploying CDM to a Citrix virtual desktop environment.