Process.Handle (Propiedad) (System.Diagnostics)

Cambiar vista

Handle (Propiedad)

Contraer todo

Filtro de lenguage

Esta página es específica de

Microsoft Visual Studio 2008/.NET Framework 3.5

Hay además otras versiones disponibles para:

Microsoft Visual Studio 2005/.NET Framework 2.0

Biblioteca de clases de .NET Framework

Process..::.Handle (Propiedad)

Actualización: noviembre 2007

Obtiene el identificador nativo del proceso asociado.

Espacio de nombres: System.Diagnostics
Ensamblado: System (en System.dll)

Sintaxis

Visual Basic (Declaración)

<BrowsableAttribute(False)> _
Public ReadOnly Property Handle As IntPtr

Visual Basic (Uso)

Dim instance As Process
Dim value As IntPtr

value = instance.Handle

[BrowsableAttribute(false)]
public IntPtr Handle { get; }

Visual C++

[BrowsableAttribute(false)]
public:
property IntPtr Handle {
    IntPtr get ();
}

/** @property */
/** @attribute BrowsableAttribute(false) */
public IntPtr get_Handle()

JScript

public function get Handle () : IntPtr

Valor de propiedad

Tipo: System..::.IntPtr
Identificador que el sistema operativo asignó al proceso asociado cuando éste se inició. El sistema utiliza este identificador para hacer un seguimiento de los atributos del proceso.

Excepciones

Excepción	Condición
InvalidOperationException	El proceso no se ha iniciado. No puede leerse la propiedad Handle porque no hay ningún proceso asociado a esta instancia de Process. O bien La instancia de Process ha quedado asociada a un proceso en ejecución, pero no se tienen los permisos necesarios para obtener un identificador con derechos de acceso total.
NotSupportedException	Se está intentando obtener acceso a la propiedad Handle de un proceso que se está ejecutando en un equipo remoto. Esta propiedad sólo está disponible para los procesos que se ejecutan en el equipo local.

Excepción

Condición

InvalidOperationException

El proceso no se ha iniciado. No puede leerse la propiedad Handle porque no hay ningún proceso asociado a esta instancia de Process.

O bien

La instancia de Process ha quedado asociada a un proceso en ejecución, pero no se tienen los permisos necesarios para obtener un identificador con derechos de acceso total.

NotSupportedException

Se está intentando obtener acceso a la propiedad Handle de un proceso que se está ejecutando en un equipo remoto. Esta propiedad sólo está disponible para los procesos que se ejecutan en el equipo local.

Comentarios

Una aplicación puede obtener un identificador de proceso que puede servir de parámetro para varias funciones de control e información del proceso. Puede utilizar este identificador para inicializar WaitHandle o para llamar a métodos nativos a través de una invocación de plataforma.

Este identificador de proceso es privado para la aplicación, es decir, no se puede compartir. Un proceso también tiene un Id de proceso que, a diferencia de Handle, es único y, por lo tanto, es válido en todo el sistema.

Sólo los procesos iniciados mediante una llamada a Start establecen la propiedad Handle de las instancias de Process correspondientes.

Permisos

LinkDemand
para que haya plena confianza para el llamador inmediato. Este miembro no puede ser utilizado por código de confianza parcial.

Plataformas

Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98

.NET Framework y .NET Compact Framework no admiten todas las versiones de cada plataforma. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.

Información de versión