Site icon EfmSoft

What does HRESULT 0x80263002 (DWM_E_REMOTING_NOT_SUPPORTED) mean?

 
Previous Next
DWM_E_COMPOSITIONDISABLED DWM_E_NO_REDIRECTION_SURFACE_AVAILABLE

DWM_E_REMOTING_NOT_SUPPORTED

DWM operation is not supported while remoting

DWM_E_REMOTING_NOT_SUPPORTED is HRESULT 0x80263002 (signed decimal -2144980990, unsigned decimal 2149986306). AllStat's winerror.h text says that some desktop-composition APIs are not supported while remoting and that the requested operation is unsupported in a remote session.

This result is a capability decision for the active presentation path. It does not mean that Remote Desktop as a whole has failed, and it does not imply that every DWM API is forbidden remotely. The caller must identify the exact operation and the session technology—full Remote Desktop, RemoteApp, virtual desktop infrastructure, console shadowing, or another remoting stack—before selecting a fallback.

Typical contract boundary

Diagnostic sequence

Difference from nearby DWM failures

DWM_E_COMPOSITIONDISABLED says the operation lacks a composition prerequisite. DWM_E_NO_REDIRECTION_SURFACE_AVAILABLE says a particular redirection surface could not be supplied. DWM_E_REMOTING_NOT_SUPPORTED is narrower: the current remote-session path does not implement the requested DWM operation. Switching adapters or shrinking a texture is not a justified response unless separate evidence identifies those conditions.

Retry and user experience

Retry is useful only after a capability-changing event, such as moving the operation to the console session, reconnecting under a supported session mode, recreating the window in the correct session, or selecting a documented remote-compatible API. A timer that repeats the same call while the session remains remote will normally repeat the same deterministic result. The application should disable only the unavailable visual feature, preserve its core function where possible, and explain that the limitation belongs to the remote presentation environment rather than reporting a generic network error.

Developer telemetry

Practical scenario

A media application enables a legacy queued-presentation feature on a local console, then the session is reconnected through Remote Desktop. The next DWM call returns DWM_E_REMOTING_NOT_SUPPORTED. The correct response is to tear down that presentation mode and use the application's ordinary remote-compatible rendering path. Repeatedly reconnecting the same DWM feature, reinstalling the display driver, or blaming media decoding would not address the documented capability boundary.

References


Looking for a different code? Search another status or error code.

Exit mobile version