Freigeben über


Process.Handle-Eigenschaft

Gibt das systemeigene Handle des zugeordneten Prozesses zurück.

Namespace: System.Diagnostics
Assembly: System (in system.dll)

Syntax

'Declaration
Public ReadOnly Property Handle As IntPtr
'Usage
Dim instance As Process
Dim value As IntPtr

value = instance.Handle
public IntPtr Handle { get; }
public:
property IntPtr Handle {
    IntPtr get ();
}
/** @property */
public IntPtr get_Handle ()
public function get Handle () : IntPtr

Eigenschaftenwert

Das Handle, das das Betriebssystem dem zugeordneten Prozess beim Starten des Prozesses zugewiesen hat. Das System verwendet dieses Handle zum Verfolgen der Prozessattribute.

Ausnahmen

Ausnahmetyp Bedingung

InvalidOperationException

Der Prozess wurde nicht gestartet. Die Handle-Eigenschaft kann nicht gelesen werden, da dieser Process-Instanz kein Prozess zugeordnet ist.

– oder –

Die Process-Instanz wurde an einen laufenden Prozess angefügt, Sie haben aber keine ausreichenden Berechtigungen zum Abrufen eines Handles mit vollen Zugriffsrechten.

NotSupportedException

Sie versuchen, auf die Handle-Eigenschaft für einen auf einem Remotecomputer ausgeführten Prozess zuzugreifen.

Hinweise

Eine Anwendung kann ein Handle für einen Prozess abrufen, das als Parameter für zahlreiche Prozessinformationen und Steuerfunktionen verwendet werden kann. Mit diesem Handle können Sie ein WaitHandle initialisieren oder systemeigene Methoden mit einem Plattformaufruf aufrufen.

Dieses Prozesshandle ist für eine Anwendung privat, d. h., Prozesshandles können nicht gemeinsam genutzt werden. Ein Prozess weist außerdem eine Prozess-Id auf, die im Gegensatz zu Handle eindeutig und daher im gesamten System gültig ist.

Nur Prozesse, die durch einen Aufruf von Start gestartet wurden, legen die Handle-Eigenschaft der entsprechenden Process-Instanzen fest.

.NET Framework-Sicherheit

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

Siehe auch

Referenz

Process-Klasse
Process-Member
System.Diagnostics-Namespace
Id
Process.ExitCode-Eigenschaft
Process.ExitTime-Eigenschaft
HandleCount
Start
Refresh