summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorJøger Hansegård <joger.hansegard@qt.io>2023-06-27 17:56:38 +0200
committerQt Cherry-pick Bot <cherrypick_bot@qt-project.org>2023-06-28 09:07:45 +0000
commit8809f93a0fac7c01c3ea49468d13adb96a98e4a8 (patch)
tree130df292f57f65df2e81db9d92486eb7fbad6931
parenta32891535458fd70ab406697db5d7c51161c5d1a (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 Change-Id: I0b6afd92f24c50ad452d2f0f7b7db53bed78e411 Reviewed-by: Volker Hilsheimer <volker.hilsheimer@qt.io> (cherry picked from commit c903b4948589fc94ef9a0dbc2ef675957f65d2c7) Reviewed-by: Qt Cherry-pick Bot <cherrypick_bot@qt-project.org>
-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