Document wxKill(wxSIGTERM) reliance on having an open window in wxMSW.

wxKill(wxSIGTERM) doesn't work if the child process has no open windows as it
doesn't have anything to post the WM_QUIT message to.

Document this and point out that wxKill(wxSIGKILL) still works in this case.

Closes #15356.

git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@74587 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775
This commit is contained in:
Vadim Zeitlin
2013-07-23 12:44:36 +00:00
parent bd6ca54f63
commit 9c34a21681

View File

@@ -1278,7 +1278,12 @@ unsigned long wxGetProcessId();
@c wxSIGNONE, @c wxSIGKILL and @c wxSIGTERM have the same meaning under
both Unix and Windows but all the other signals are equivalent to
@c wxSIGTERM under Windows.
@c wxSIGTERM under Windows. Moreover, under Windows, @c wxSIGTERM is
implemented by posting a message to the application window, so it only
works if the application does have windows. If it doesn't, as is notably
always the case for the console applications, you need to use @c wxSIGKILL
to actually kill the process. Of course, this doesn't allow the process to
shut down gracefully and so should be avoided if possible.
Returns 0 on success, -1 on failure. If the @a rc parameter is not @NULL,
it will be filled with a value from the @c wxKillError enum: