GetEnhMetaFileBits 함수(wingdi.h)

GetEnhMetaFileBits 함수는 지정된 고급 형식 메타파일의 내용을 검색하여 버퍼에 복사합니다.

구문

UINT GetEnhMetaFileBits(
  [in]  HENHMETAFILE hEMF,
  [in]  UINT         nSize,
  [out] LPBYTE       lpData
);

[in] hEMF

향상된 메타파일의 핸들입니다.

[in] nSize

데이터를 수신할 버퍼의 크기(바이트)입니다.

[out] lpData

메타파일 데이터를 수신하는 버퍼에 대한 포인터입니다. 버퍼는 데이터를 포함하기에 충분히 커야 합니다. lpbBuffer가 NULL이면 함수는 데이터를 보유하는 데 필요한 크기를 반환합니다.

함수가 성공하고 버퍼 포인터가 NULL이면 반환 값은 향상된 메타파일의 크기(바이트)입니다.

함수가 성공하고 버퍼 포인터가 유효한 포인터인 경우 반환 값은 버퍼에 복사된 바이트 수입니다.

함수가 실패하면 반환 값은 0입니다.

고급 메타파일 비트를 검색한 후 SetEnhMetaFileBits 함수를 호출하여 메모리 기반 메타파일을 만드는 데 사용할 수 있습니다.

GetEnhMetaFileBits 함수는 enhanced-metafile 핸들을 무효화하지 않습니다. 애플리케이션은 더 이상 필요하지 않은 경우 DeleteEnhMetaFile 함수를 호출하여 핸들을 삭제해야 합니다.

이 함수에서 검색한 메타파일 콘텐츠는 향상된 형식입니다. Windows 형식으로 메타파일 콘텐츠를 검색하려면 GetWinMetaFileBits 함수를 사용합니다.


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