Freigeben über


Process.CloseMainWindow Methode

Definition

Schließt einen Prozess mit einer Benutzeroberfläche, indem eine Meldung zum Schließen an das Hauptfenster gesendet wird.

public:
 bool CloseMainWindow();
public bool CloseMainWindow ();
member this.CloseMainWindow : unit -> bool
Public Function CloseMainWindow () As Boolean

Gibt zurück

true, wenn die Meldung zum Schließen erfolgreich gesendet wurde. false, wenn der zugeordnete Prozess nicht über ein Hauptfenster verfügt oder wenn das Hauptfenster deaktiviert ist (z. B., wenn ein modales Dialogfeld angezeigt wird).

Ausnahmen

Der Prozess wurde bereits beendet.

- oder -

Diesem Process-Objekt ist kein Prozess zugeordnet.

Beispiele

Im folgenden Beispiel wird eine instance von Editor gestartet. Anschließend wird die physische Speicherauslastung des zugeordneten Prozesses in Intervallen von 2 Sekunden für maximal 10 Sekunden abgerufen. Im Beispiel wird ermittelt, ob der Prozess beendet wird, bevor 10 Sekunden verstrichen sind. Im Beispiel wird der Prozess geschlossen, wenn er nach 10 Sekunden noch ausgeführt wird.

#using <System.dll>

using namespace System;
using namespace System::Diagnostics;
using namespace System::Threading;
int main()
{
   try
   {
      Process^ myProcess;
      myProcess = Process::Start(  "Notepad.exe" );
      
      // Display physical memory usage 5 times at intervals of 2 seconds.
      for ( int i = 0; i < 5; i++ )
      {
         if (  !myProcess->HasExited )
         {
            
            // Discard cached information about the process.
            myProcess->Refresh();
            
            // Print working set to console.
            Console::WriteLine( "Physical Memory Usage : {0}", myProcess->WorkingSet.ToString() );
            
            // Wait 2 seconds.
            Thread::Sleep( 2000 );
         }
         else
         {
            break;
         }

      }
      myProcess->CloseMainWindow();
      
      // Free resources associated with process.
      myProcess->Close();
   }
   catch ( Exception^ e ) 
   {
      Console::WriteLine( "The following exception was raised: " );
      Console::WriteLine( e->Message );
   }

}
using System;
using System.ComponentModel;
using System.Diagnostics;
using System.IO;
using System.Threading;

namespace ProcessSample
{
    class MyProcessClass
    {
        public static void Main()
        {
            try
            {
                using (Process myProcess = Process.Start("Notepad.exe"))
                {
                    // Display physical memory usage 5 times at intervals of 2 seconds.
                    for (int i = 0; i < 5; i++)
                    {
                        if (!myProcess.HasExited)
                        {
                            // Discard cached information about the process.
                            myProcess.Refresh();
                            // Print working set to console.
                            Console.WriteLine($"Physical Memory Usage: {myProcess.WorkingSet}");
                            // Wait 2 seconds.
                            Thread.Sleep(2000);
                        }
                        else
                        {
                            break;
                        }
                    }

                    // Close process by sending a close message to its main window.
                    myProcess.CloseMainWindow();
                    // Free resources associated with process.
                    myProcess.Close();
                }
            }
            catch (Exception e) when (e is Win32Exception || e is FileNotFoundException)
            {
                Console.WriteLine("The following exception was raised: ");
                Console.WriteLine(e.Message);
            }
        }
    }
}
Imports System.ComponentModel
Imports System.Diagnostics
Imports System.IO
Imports System.Threading

Namespace Process_Sample
    Class MyProcessClass

        Public Shared Sub Main()
            Try
                Using myProcess = Process.Start("Notepad.exe")
                    ' Display physical memory usage 5 times at intervals of 2 seconds.
                    Dim i As Integer
                    For i = 0 To 4
                        If Not myProcess.HasExited Then

                            ' Discard cached information about the process.
                            myProcess.Refresh()
                            ' Print working set to console.
                            Console.WriteLine($"Physical Memory Usage: {myProcess.WorkingSet}")
                            ' Wait 2 seconds.
                            Thread.Sleep(2000)
                        Else
                            Exit For
                        End If

                    Next i

                    ' Close process by sending a close message to its main window.
                    myProcess.CloseMainWindow()
                    ' Free resources associated with process.
                    myProcess.Close()
                End Using
            Catch e As Exception When TypeOf e Is Win32Exception Or TypeOf e Is FileNotFoundException
                Console.WriteLine("The following exception was raised: ")
                Console.WriteLine(e.Message)
            End Try
        End Sub
    End Class
End Namespace 'Process_Sample

Hinweise

Wenn ein Prozess ausgeführt wird, befindet sich seine Nachrichtenschleife in einem Wartezustand. Die Nachrichtenschleife wird jedes Mal ausgeführt, wenn eine Windows-Nachricht vom Betriebssystem an den Prozess gesendet wird. Der Aufruf CloseMainWindow sendet eine Anforderung zum Schließen des Standard-Fensters, das in einer wohlgeformten Anwendung untergeordnete Fenster schließt und alle ausgeführten Nachrichtenschleifen für die Anwendung widerruft. Die Anforderung, den Prozess durch Aufrufen CloseMainWindow zu beenden, erzwingt nicht das Beenden der Anwendung. Die Anwendung kann eine Benutzerüberprüfung anfordern, bevor sie beendet wird, oder sie kann das Beenden ablehnen. Verwenden Sie die -Methode, um das Beenden der Anwendung zu erzwingen Kill . Das Verhalten von CloseMainWindow ist identisch mit dem Verhalten eines Benutzers, der das Standard Fenster einer Anwendung über das Systemmenü schließt. Daher erzwingt die Anforderung, den Prozess durch Schließen des Standard-Fensters zu beenden, nicht, dass die Anwendung sofort beendet wird.

Daten, die vom Prozess bearbeitet werden, oder ressourcen, die dem Prozess zugeordnet sind, können verloren gehen, wenn Sie aufrufen Kill. Kill verursacht eine ungewöhnliche Prozessbeendigung und sollte nur bei Bedarf verwendet werden. CloseMainWindow ermöglicht eine geordnete Beendigung des Prozesses und schließt alle Fenster, sodass dies für Anwendungen mit einer Schnittstelle vorzuziehen ist. Wenn CloseMainWindow ein Fehler auftritt, können Kill Sie verwenden, um den Prozess zu beenden. Kill ist die einzige Möglichkeit, Prozesse ohne grafische Schnittstellen zu beenden.

Rufen Sie Kill und CloseMainWindow nur für Prozesse, die auf dem lokalen Computer ausgeführt werden. Sie können nicht bewirken, dass Prozesse auf Remotecomputern beendet werden. Sie können nur Informationen zu Prozessen anzeigen, die auf Remotecomputern ausgeführt werden.

Gilt für: