GetHandleInformation 함수(handleapi.h)

개체 핸들의 특정 속성을 검색합니다.

구문

BOOL GetHandleInformation(
  [in]  HANDLE  hObject,
  [out] LPDWORD lpdwFlags
);

[in] hObject

정보를 검색할 개체에 대한 핸들입니다.

액세스 토큰, 콘솔 입력 버퍼, 콘솔 화면 버퍼, 이벤트, 파일, 파일 매핑, 작업, 메일 슬롯, 뮤텍스, 파이프, 프린터, 프로세스, 레지스트리 키, 세마포, 직렬 통신 디바이스, 소켓, 스레드 또는 대기 가능한 타이머 중 하나에 대한 핸들을 지정할 수 있습니다.

[out] lpdwFlags

개체 핸들 또는 0의 속성을 지정하는 비트 플래그 집합을 수신하는 변수에 대한 포인터입니다. 다음 값이 정의됩니다.

값	의미
HANDLE_FLAG_INHERIT 0x00000001	이 플래그가 설정되면 CreateProcess의 bInheritHandles 매개 변수를 TRUE로 설정하여 만든 자식 프로세스가 개체 핸들을 상속합니다.
HANDLE_FLAG_PROTECT_FROM_CLOSE 0x00000002	이 플래그가 설정되면 CloseHandle 함수를 호출하면 개체 핸들이 닫히지 않습니다.

함수가 성공하면 반환 값이 0이 아닙니다.

함수가 실패하면 반환 값은 0입니다. 확장 오류 정보를 가져오려면 GetLastError를 호출합니다.

요구 사항	값
지원되는 최소 클라이언트	Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버	Windows 2000 Server[데스크톱 앱만]
대상 플랫폼	Windows
헤더	handleapi.h(Windows.h 포함)
라이브러리	Kernel32.lib
DLL	Kernel32.dll