summaryrefslogtreecommitdiffstats
path: root/src
diff options
context:
space:
mode:
authorJøger Hansegård <joger.hansegard@qt.io>2023-06-27 17:56:38 +0200
committerJøger Hansegård <joger.hansegard@qt.io>2023-06-28 10:37:18 +0200
commitc903b4948589fc94ef9a0dbc2ef675957f65d2c7 (patch)
tree91e8a705896a590bc4466e95ce965731ce8b6c74 /src
parent4584dbdd7ebcd0a2087b335470585c366e30fb90 (diff)
doc: Document that unloading in-process Active Qt may cause crash
Statically allocated Qt resources created by an Active Qt COM server may become corrupted after unloading the COM server dll, if Qt modules other than those found in QtBase are used. This change adds a DOC warning about this problem and suggests a workaround. Fixes: QTBUG-56172 Pick-to: 6.5 6.6 Change-Id: I0b6afd92f24c50ad452d2f0f7b7db53bed78e411 Reviewed-by: Volker Hilsheimer <volker.hilsheimer@qt.io>
Diffstat (limited to 'src')
-rw-r--r--src/activeqt/doc/src/qtaxserver.qdoc7
1 files changed, 7 insertions, 0 deletions
diff --git a/src/activeqt/doc/src/qtaxserver.qdoc b/src/activeqt/doc/src/qtaxserver.qdoc
index df76368..ced88a3 100644
--- a/src/activeqt/doc/src/qtaxserver.qdoc
+++ b/src/activeqt/doc/src/qtaxserver.qdoc
@@ -658,6 +658,13 @@
If the server runs, see the following section for information on
debugging your server.
+ \section3 Crashes when unloading and reloading COM servers
+
+ If ActiveQt COM servers utilize Qt modules beyond those found in Qt Base, it
+ is necessary to activate the COM server as an out-of-process COM server.
+ Attempting to activate an in-process COM server that includes modules such
+ as Qt Quick may result in a crash after unloading the COM server.
+
\section2 Debugging Runtime Errors
To debug an in-process server in Visual Studio, set the server project