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
commit548f9e1bb327ff6e90fc6d4cb80ea510b60f848a (patch)
tree3254ff51cd12106afe22581d75c34cdf1bb800db
parentee41db87d215ef23d473f3dbc6e4e3055b5a3bca (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