OleMetafilePictFromIconAndLabel 함수(ole2.h)

지정된 아이콘과 레이블이 그려지는 메타파일을 만듭니다.

구문

HGLOBAL OleMetafilePictFromIconAndLabel(
  [in] HICON    hIcon,
  [in] LPOLESTR lpszLabel,
  [in] LPOLESTR lpszSourceFile,
  [in] UINT     iIconIndex
);

매개 변수

[in] hIcon

메타파일로 그릴 아이콘에 대한 핸들입니다. 이 매개 변수는 NULL일 수 있습니다. hIcon이 NULL인 경우 이 함수는 메타파일을 만들지 않고 NULL을 반환합니다.

[in] lpszLabel

아이콘 레이블입니다. 이 매개 변수는 NULL일 수 있습니다. lpszLabel이 NULL인 경우 결과 메타파일은 레이블을 포함하지 않습니다.

[in] lpszSourceFile

아이콘 파일의 경로 및 파일 이름입니다. 이 문자열은 사용자 인터페이스 또는 등록 데이터베이스에서 가져올 수 있습니다. 이 매개 변수는 NULL일 수 있습니다.

[in] iIconIndex

파일 시작부터 오프셋(바이트)으로 표현되는 lpszSourceFile으로 명명된 파일 내 아이콘의 위치입니다.

반환 값

아이콘과 레이블을 포함하는 METAFILEPICT 구조체에 대한 전역 핸들입니다. 메타파일은 MM_ANISOTROPIC 매핑 모드를 사용합니다.

오류가 발생하면 반환된 핸들은 NULL입니다. 이 경우 호출자는 GetLastError 를 호출하여 추가 정보를 가져올 수 있습니다.

설명

이 함수는 OleGetIconOfFile 및 OleGetIconOfClass에서 호출됩니다.

lpszSourceFile이 NULL이 아니고 iIconIndex가 0이 아니면 lpszSourceFile에 전달된 원본 파일의 이름과 iIconIndex에서 전달된 인덱스가 생성된 메타파일에 주석 레코드로 추가됩니다.

요구 사항

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

추가 정보

OleGetIconOfClass

OleGetIconOfFile