IExtractIconA::Extract 메서드(shlobj_core.h)

지정된 위치에서 아이콘 이미지를 추출합니다.

구문

HRESULT Extract(
  [in]            PCSTR pszFile,
                  UINT  nIconIndex,
  [out, optional] HICON *phiconLarge,
  [out, optional] HICON *phiconSmall,
                  UINT  nIconSize
);

매개 변수

[in] pszFile

형식: PCTSTR

아이콘 위치를 지정하는 null로 끝나는 문자열에 대한 포인터입니다.

nIconIndex

형식: UINT

pszFile이 가리키는 파일의 아이콘 인덱스입니다.

[out, optional] phiconLarge

형식: HICON*

큰 아이콘에 대한 핸들을 수신하는 HICON 값에 대한 포인터입니다. 이 매개 변수는 NULL일 수 있습니다.

[out, optional] phiconSmall

형식: HICON*

작은 아이콘에 대한 핸들을 받는 HICON 값에 대한 포인터입니다. 이 매개 변수는 NULL일 수 있습니다.

nIconSize

형식: UINT

아이콘의 원하는 크기(픽셀)입니다. 낮은 단어는 큰 아이콘의 크기를 포함하고, 높은 단어는 작은 아이콘의 크기를 포함합니다. 지정된 크기는 너비 또는 높이일 수 있습니다. 아이콘의 너비는 항상 높이와 같습니다.

반환 값

형식: HRESULT

함수가 아이콘을 추출한 경우 S_OK 반환하거나 호출 애플리케이션이 아이콘을 추출해야 하는지 S_FALSE.

설명

아이콘 위치 및 인덱스는 IExtractIcon::GetIconLocation 메서드에서 반환하는 값과 동일합니다. IExtractIcon::Extract 함수가 S_FALSE 반환하는 경우 이러한 값은 ExtractIcon 호출에 대한 법적 매개 변수를 형성하는 아이콘 파일 이름과 인덱스를 지정해야 합니다. IExtractIcon::Extract가 S_FALSE 반환하지 않으면 pszFile 및 nIconIndex 매개 변수의 의미에 대해 가정해서는 안 됩니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows XP [데스크톱 앱만 해당]
지원되는 최소 서버	Windows 2000 Server[데스크톱 앱만]
대상 플랫폼	Windows
헤더	shlobj_core.h
DLL	Shell32.dll(버전 4.0 이상)

추가 정보

IExtractIcon