Process.MainWindowHandle Process.MainWindowHandle Process.MainWindowHandle Process.MainWindowHandle Property

정의

연결된 프로세스의 주 창에 대한 창 핸들을 가져옵니다. Gets the window handle of the main window of the associated process.

public:
 property IntPtr MainWindowHandle { IntPtr get(); };
public IntPtr MainWindowHandle { get; }
member this.MainWindowHandle : nativeint
Public ReadOnly Property MainWindowHandle As IntPtr
속성 값

연결된 프로세스의 주 창에 대한 창 핸들입니다. 이 창 핸들은 시스템에서 생성됩니다. The system-generated window handle of the main window of the associated process.

예외

프로세스가 종료되어 MainWindowHandle이 정의되지 않은 경우 The MainWindowHandle is not defined because the process has exited.

원격 컴퓨터에서 실행 중인 프로세스에 대한 MainWindowHandle 속성에 액세스하려고 합니다. You are trying to access the MainWindowHandle property for a process that is running on a remote computer. 이 속성은 로컬 컴퓨터에서 실행되는 프로세스에만 사용할 수 있습니다. This property is available only for processes that are running on the local computer.

플랫폼은 Windows 98 또는 Windows Me(Windows Millennium Edition)입니다. Windows 98 및 Windows Me에서 이 속성에 액세스하려면 UseShellExecutefalse로 설정합니다. The platform is Windows 98 or Windows Millennium Edition (Windows Me); set UseShellExecute to false to access this property on Windows 98 and Windows Me.

설명

기본 기간은 현재 포커스를가지고 하는 프로세스에 의해 열린 창을 (의 TopLevel 양식).The main window is the window opened by the process that currently has the focus (the TopLevel form). 사용 해야 합니다는 Refresh 새로 고침 하는 방법의 Process 변경 된 경우 현재 주 창 핸들을 가져올 개체입니다.You must use the Refresh method to refresh the Process object to get the current main window handle if it has changed. 창 핸들을 캐시 되므로 일반적으로 사용 Refresh 현재 핸들을 검색할 수 있다고 보장 하기 위해 미리 합니다.In general, because the window handle is cached, use Refresh beforehand to guarantee that you’ll retrieve the current handle.

가져올 수 있습니다는 MainWindowHandle 로컬 컴퓨터에서 실행 중인 프로세스에 대해서만 속성입니다.You can get the MainWindowHandle property only for processes that are running on the local computer. MainWindowHandle 속성이 프로세스와 관련 된 창을 고유 하 게 식별 하는 값입니다.The MainWindowHandle property is a value that uniquely identifies the window that is associated with the process.

프로세스에 프로세스 그래픽 인터페이스가 하는 경우에 연결 된 주 창이 있습니다.A process has a main window associated with it only if the process has a graphical interface. 연결된 된 프로세스에 주 창이 없는 경우는 MainWindowHandle 값은 0입니다.If the associated process does not have a main window, the MainWindowHandle value is zero. 값 0 숨겨져 있는 경우는 프로세스, 작업 표시줄에 표시 되지 않는 처리 이기도 합니다.The value is also zero for processes that have been hidden, that is, processes that are not visible in the taskbar. 이 작업 표시줄의 맨 오른쪽 알림 영역에서 아이콘으로 표시 되는 프로세스에 대 한 사례 수 있습니다.This can be the case for processes that appear as icons in the notification area, at the far right of the taskbar.

프로세스를 방금 시작한 경우의 주 창 핸들을 사용 하려면 사용을 고려 합니다 WaitForInputIdle 주 창 핸들이 만들어졌는지 확인 시작이 완료 하는 프로세스를 허용 하는 방법입니다.If you have just started a process and want to use its main window handle, consider using the WaitForInputIdle method to allow the process to finish starting, ensuring that the main window handle has been created. 그렇지 않으면 예외가 throw됩니다.Otherwise, an exception will be thrown.

보안

LinkDemand
직접 실행 호출자에 대 한 완전 신뢰 합니다. for full trust for the immediate caller. 이 멤버는 부분적으로 신뢰할 수 있는 코드에서 사용할 수 없습니다. This member cannot be used by partially trusted code.

적용 대상

추가 정보