SHUpdateImageW 함수(shlobj_core.h)
셸에 시스템 이미지 목록의 이미지가 변경되었음을 알 수 있습니다.
구문
void SHUpdateImageW(
[in] LPCWSTR pszHashItem,
[in] int iIndex,
[in] UINT uFlags,
[in] int iImageIndex
);
매개 변수
[in] pszHashItem
형식: LPCTSTR
아이콘이 포함된 파일의 정규화된 경로를 지정하는 문자열 값에 대한 포인터입니다. IExtractIcon::GetIconLocation의 szIconFile 매개 변수가 가리키는 버퍼에 반환되는 경로를 사용합니다.
[in] iIndex
형식: int
pszHashItem으로 지정된 파일에서 아이콘의 인덱스(0부터 시작)를 지정하는 정수입니다. IExtractIcon::GetIconLocation의 piIndex 매개 변수가 가리키는 값을 사용합니다.
[in] uFlags
형식: UINT
아이콘 특성을 결정하는 플래그를 지정하는 부호 없는 정수입니다. uFlags를IExtractIcon::GetIconLocation의 pwFlags 매개 변수가 가리키는 값으로 설정합니다. SHUpdateImage와 관련된 플래그는 GIL_NOTFILENAMEGIL_SIMULATEDOC.
[in] iImageIndex
형식: int
업데이트되는 아이콘의 시스템 이미지 목록에서 인덱스를 지정하는 정수입니다.
반환 값
없음
설명
업데이트하려는 아이콘의 시스템 이미지 목록에서 인덱스를 모르는 경우 uFlags 매개 변수가 SHGFI_SYSICONINDEX 설정된 SHGetFileInfo를 사용합니다.
IExtractIcon::GetIconLocation을 교체하려는 새 아이콘이 아니라 업데이트해야 하는 이전 아이콘의 매개 변수와 함께 사용해야 합니다.
참고
shlobj_core.h 헤더는 UNICODE 전처리기 상수의 정의에 따라 이 함수의 ANSI 또는 유니코드 버전을 자동으로 선택하는 별칭으로 SHUpdateImage를 정의합니다. 인코딩 중립 별칭을 인코딩 중립이 아닌 코드와 혼합하면 컴파일 또는 런타임 오류가 발생하는 불일치가 발생할 수 있습니다. 자세한 내용은 함수 프로토타입에 대한 규칙을 참조하세요.
요구 사항
| 지원되는 최소 클라이언트 | Windows 2000 Professional, Windows XP [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2003 [데스크톱 앱만 해당] |
| 대상 플랫폼 | Windows |
| 헤더 | shlobj_core.h(Shlobj.h, Shlobj_core.h 포함) |
| 라이브러리 | Shell32.lib |
| DLL | Shell32.dll(버전 4.7 이상) |