문서를 영문으로 보려면 영문 확인란을 선택하세요. 마우스 포인터를 텍스트 위로 이동시켜 팝업 창에서 영문 텍스트를 표시할 수도 있습니다.
번역
영문
이 설명서는 보관되지만 유지 되지 않습니다.

Process.MainWindowHandle 속성

연결된 프로세스의 주 창에 대한 창 핸들을 가져옵니다.

네임스페이스:  System.Diagnostics
어셈블리:  System(System.dll)

public IntPtr MainWindowHandle { get; }

속성 값

형식: System.IntPtr
연결된 프로세스의 주 창에 대한 창 핸들입니다. 이 창 핸들은 시스템에서 생성됩니다.

예외상황
InvalidOperationException

프로세스가 종료되어 MainWindowHandle이 정의되지 않은 경우

NotSupportedException

원격 컴퓨터에서 실행 중인 프로세스의 MainWindowHandle 속성에 액세스한 경우. 이 속성은 로컬 컴퓨터에서 실행 중인 프로세스에 대해서만 사용할 수 있습니다.

PlatformNotSupportedException

플랫폼이 Windows 98 또는 Windows Millennium Edition(Me)입니다. Windows 98 및 Windows Me에서 이 속성에 액세스하려면 ProcessStartInfo.UseShellExecutefalse로 설정합니다.

주 창은 프로세스를 시작할 때 만들어지는 창입니다. 초기화를 마치고 나면 ModalTopLevel 창을 비롯한 다른 창이 열릴 수 있지만 프로세스와 관련된 첫째 창이 주 창으로 남습니다.

로컬 컴퓨터에서 실행 중인 프로세스에 대해서만 MainWindowHandle 속성을 가져올 수 있습니다. MainWindowHandle 속성은 프로세스에 연결된 창을 고유하게 식별하는 값입니다.

프로세스에 그래픽 인터페이스가 있는 경우에만 프로세스에 연결된 주 창이 있습니다. 연결된 프로세스에 주 창이 없으면 MainWindowHandle 값은 0입니다. 값은 숨겨진 프로세스, 즉 작업 표시줄에 나타나지 않는 프로세스의 경우 0입니다. 이는 작업 표시줄 맨 오른쪽에 있는 알림 영역의 아이콘으로 나타나는 프로세스에 해당될 수 있습니다.

프로세스를 시작한 직후에 해당 프로세스의 주 창 핸들을 사용하려면 프로세스 시작이 완료되어 주 창 핸들이 만들어질 수 있도록 WaitForInputIdle 메서드를 사용하십시오. 그렇지 않으면 예외가 throw됩니다.

플랫폼 참고: ProcessStartInfo.UseShellExecute true로 설정하여 프로세스를 시작한 경우에는 이 플랫폼에서 이 속성을 사용할 수 없습니다.

.NET Framework

4, 3.5, 3.0, 2.0, 1.1, 1.0에서 지원

.NET Framework Client Profile

4, 3.5 SP1에서 지원

  • LinkDemand 

    직접 실행 호출자에 대한 완전 신뢰에 사용됩니다. 이 멤버는 부분적으로 신뢰할 수 있는 코드에서는 사용할 수 없습니다.

Windows 7, Windows Vista SP1 이상, Windows XP SP3, Windows XP SP2 x64 버전, Windows Server 2008(Server Core는 지원되지 않음), Windows Server 2008 R2(Server Core는 SP1 이상에서 지원됨), Windows Server 2003 SP2

.NET Framework에서 모든 플랫폼의 전체 버전을 지원하지는 않습니다. 지원되는 버전의 목록을 보려면 .NET Framework 시스템 요구 사항을 참조하십시오.
표시: