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 이상)

추가 정보

SHChangeNotify