SetHandleInformation 함수(handleapi.h)

  • 아티클

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

구문

BOOL SetHandleInformation(
  [in] HANDLE hObject,
  [in] DWORD  dwMask,
  [in] DWORD  dwFlags
);

매개 변수

[in] hObject

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

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

[in] dwMask

변경할 비트 플래그를 지정하는 마스크입니다. dwFlags 설명에 표시된 것과 동일한 상수를 사용합니다.

[in] dwFlags

개체 핸들의 속성을 지정하는 비트 플래그 집합입니다. 이 매개 변수는 다음 값 중 0개 이상일 수 있습니다.

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

반환 값

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

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

설명

dwFlags에서 연결된 비트 플래그를 설정하거나 지우려면 dwMask에서 변경 마스크 비트 플래그를 설정해야 합니다.

요구 사항

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

참고 항목

CloseHandle

CreateProcess

GetHandleInformation

핸들 및 개체 함수