Esta documentación está archivada y no tiene mantenimiento.

Process.MainWindowHandle (Propiedad)

Actualización: noviembre 2007

Obtiene el identificador de ventana de la ventana principal del proceso asociado.

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

public IntPtr MainWindowHandle { get; }
/** @property */
public IntPtr get_MainWindowHandle()

public function get MainWindowHandle () : IntPtr

Valor de propiedad

Tipo: System.IntPtr
Identificador de ventana generado por el sistema para la ventana principal del proceso asociado.

ExcepciónCondición
InvalidOperationException

La propiedad MainWindowHandle no está definida porque el proceso ha terminado.

NotSupportedException

Se está intentando obtener acceso a la propiedad MainWindowHandle 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.

PlatformNotSupportedException

La plataforma es Windows 98 o Windows Millennium (Windows Me); establezca el valor de ProcessStartInfo.UseShellExecute en false para tener acceso a esta propiedad en Windows 98 y Windows Me.

La ventana principal es la ventana que se crea al iniciarse el proceso. Tras la inicialización, pueden abrirse otras ventanas, incluidas las ventanas Modal y TopLevel, pero la primera ventana asociada al proceso seguirá siendo la ventana principal.

Sólo es posible obtener la propiedad MainWindowHandle de los procesos que se estén ejecutando en el equipo local. La propiedad MainWindowHandle es un valor que identifica de forma inequívoca la ventana que está asociada al proceso.

Para que un proceso tenga una ventana principal asociada, debe disponer de una interfaz gráfica. Si el proceso asociado no tiene una ventana principal, el valor de la propiedad MainWindowHandle es cero. Si acaba de iniciar un proceso y desea utilizar el identificador de ventana principal, considere la posibilidad de utilizar el método WaitForInputIdle para permitir que el proceso termine de iniciarse; así se garantiza la creación del identificador de ventana principal. De lo contrario, se producirá una excepción.

Nota de la plataforma Windows 98, Windows Millennium Edition:

Esta propiedad no se encuentra disponible en esta plataforma si el proceso se ha iniciado con la propiedad ProcessStartInfo.UseShellExecute establecida en true.

  • LinkDemand 

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

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, Windows CE, Windows Mobile para Smartphone, Windows Mobile para Pocket PC

.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.

.NET Framework

Compatible con: 3.5, 3.0, 2.0, 1.1, 1.0

.NET Compact Framework

Compatible con: 3.5, 2.0
Mostrar: