Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Ruft das Fensterhandle des Hauptfensters des zugeordneten Prozesses ab.
Namespace: System.Diagnostics
Assembly: System (in system.dll)
Syntax
'Declaration
Public ReadOnly Property MainWindowHandle As IntPtr
'Usage
Dim instance As Process
Dim value As IntPtr
value = instance.MainWindowHandle
public IntPtr MainWindowHandle { get; }
public:
property IntPtr MainWindowHandle {
IntPtr get ();
}
/** @property */
public IntPtr get_MainWindowHandle ()
public function get MainWindowHandle () : IntPtr
Eigenschaftenwert
Das vom System generierte Fensterhandle des Hauptfensters des zugeordneten Prozesses.
Ausnahmen
| Ausnahmetyp | Bedingung |
|---|---|
MainWindowHandle ist nicht definiert, da der Prozess beendet wurde. |
|
Sie versuchen, MainWindowHandle für einen auf einem Remotecomputer ausgeführten Prozess abzurufen. |
|
Die Plattform ist Windows 98 oder Windows Millennium Edition (Windows Me). Legen Sie ProcessStartInfo.UseShellExecute auf false fest, um auf diese Eigenschaft unter Windows 98 und Windows Me zuzugreifen. |
Hinweise
Sie können die MainWindowHandle-Eigenschaft nur für Prozesse abrufen, die auf dem lokalen Computer ausgeführt werden. Die MainWindowHandle-Eigenschaft ist ein Wert, der das dem Prozess zugeordnete Fenster eindeutig bezeichnet.
Einem Prozess ist nur dann ein Hauptfenster zugeordnet, wenn er über eine grafische Oberfläche verfügt. Wenn der zugeordnete Prozess nicht über ein Hauptfenster verfügt, ist der MainWindowHandle-Wert 0. Wenn Sie einen Prozess gestartet haben und dessen Hauptfensterhandle verwenden möchten, empfiehlt es sich, mithilfe der WaitForInputIdle-Methode das Abschließen des Startvorgangs des Prozesses zu ermöglichen und das Erstellen des Hauptfensterhandles sicherzustellen. Andernfalls wird eine Ausnahme ausgelöst.
Hinweis zu Windows 98, Windows Millennium Edition: Diese Eigenschaft ist auf dieser Plattform nicht verfügbar, wenn beim Starten des Prozesses ProcessStartInfo.UseShellExecute auf true festgelegt ist.
.NET Framework-Sicherheit
- SecurityPermission zum Aufrufen von Process-Membern. Anforderungswert: LinkDemand; Benannte Berechtigungssätze: FullTrust.
Plattformen
Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.
Versionsinformationen
.NET Framework
Unterstützt in: 2.0, 1.1, 1.0
.NET Compact Framework
Unterstützt in: 2.0
Siehe auch
Referenz
Process-Klasse
Process-Member
System.Diagnostics-Namespace
MainWindowTitle
Process.MainModule-Eigenschaft