SHGetStockIconInfo 함수(shellapi.h)

아티클
03/15/2023

시스템 정의 셸 아이콘에 대한 정보를 검색합니다.

구문

SHSTDAPI SHGetStockIconInfo(
            SHSTOCKICONID   siid,
            UINT            uFlags,
  [in, out] SHSTOCKICONINFO *psii
);

매개 변수

siid

형식: SHSTOCKICONID

검색할 아이콘을 지정하는 SHSTOCKICONID 열거형의 값 중 하나입니다.

uFlags

형식: UINT

요청되는 정보를 지정하는 다음 플래그 중 0개 이상의 조합입니다.

SHGSI_ICONLOCATION

SHSTOCKICONINFO 구조체의 szPath 및 iIcon 멤버는 ExtractIcon 함수에 전달하기에 적합한 형식으로 요청된 아이콘의 경로 및 아이콘 인덱스를 받습니다. 이 플래그의 숫자 값은 0이므로 다른 플래그에 관계없이 항상 아이콘 위치를 가져옵니다.

SHGSI_ICON

SHSTOCKICONINFO 구조체의 hIcon 멤버는 지정된 아이콘에 대한 핸들을 받습니다.

SHGSI_SYSICONINDEX

SHSTOCKICONINFO 구조체의 iSysImageImage 멤버는 시스템 이미지 목록에서 지정된 아이콘의 인덱스를 받습니다.

SHGSI_LINKOVERLAY

함수가 파일의 아이콘에 링크 오버레이를 추가하도록 하여 SHGSI_ICON 값을 수정합니다.

SHGSI_SELECTED

함수가 아이콘을 시스템 강조 색과 혼합하도록 하여 SHGSI_ICON 값을 수정합니다.

SHGSI_LARGEICON

SM_CXICON 및 SM_CYICON 시스템 메트릭에 지정된 대로 함수가 큰 버전의 아이콘을 검색하도록 하여 SHGSI_ICON 값을 수정합니다.

SHGSI_SMALLICON

함수가 SM_CXSMICON 및 SM_CYSMICON 시스템 메트릭에 지정된 대로 작은 버전의 아이콘을 검색하도록 하여 SHGSI_ICON 값을 수정합니다.

SHGSI_SHELLICONSIZE

함수가 시스템 메트릭에 지정된 크기가 아닌 셸 크기 아이콘을 검색하도록 하여 SHGSI_LARGEICON 또는 SHGSI_SMALLICON 값을 수정합니다.

[in, out] psii

형식: SHSTOCKICONINFO*

SHSTOCKICONINFO 구조체에 대한 포인터입니다. 이 함수가 호출되면 이 구조체의 cbSize 멤버를 SHSTOCKICONINFO 구조체의 크기로 설정해야 합니다. 이 함수가 반환되면 요청된 정보를 포함하는 SHSTOCKICONINFO 구조체에 대한 포인터가 포함됩니다.

반환 값

형식: HRESULT

이 함수가 성공하면 S_OK 반환합니다. 그러지 않으면 HRESULT 오류 코드를 반환합니다.

설명

이 함수가 psii가 가리키는 SHSTOCKICONINFO 구조체의 hIcon 멤버에서 아이콘 핸들을 반환하는 경우 더 이상 필요하지 않을 때 DestroyIcon을 사용하여 아이콘을 해제해야 합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2008 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	shellapi.h
DLL	Shell32.dll
API 세트	ext-ms-win-shell-shell32-l1-2-1(Windows 10 버전 10.0.10240에 도입됨)

다음을 통해 공유