SHHandleUpdateImage 함수(shlobj_core.h)
[SHHandleUpdateImage 는 요구 사항 섹션에 지정된 운영 체제에서 사용할 수 있습니다. 이후 버전에서는 변경되거나 제공되지 않을 수 있습니다.]
SHCNE_UPDATEIMAGE 셸 변경 알림을 처리합니다.
구문
int SHHandleUpdateImage(
[in] PCIDLIST_ABSOLUTE pidlExtra
);
매개 변수
[in] pidlExtra
형식: PCIDLIST_ABSOLUTE
IShellChangeNotify::OnChange의 pidl2 매개 변수에 지정된 변경된 시스템 이미지 목록의 인덱스입니다.
반환 값
형식: int
실패 시 -1을 반환하거나 성공 시 변경된 이미지 목록 항목의 인덱스입니다.
설명
변경 알림 콜백에서 받은 pidl2 매개 변수가 NULL이 아닌 경우에만 SHHandleUpdateImage를 사용합니다.
예제
다음 예제에서는 IShellChangeNotify::OnChange 구현에서 SHHandleUpdateImage를 사용하는 방법을 보여 줍니다.
STDMETHODIMP CMyShellChangeNotify::OnChange(LONG lEvent,
LPCITEMIDLIST pidl1,
LPCITEMIDLIST pidl2)
{
HRESULT hr = E_FAIL;
int iImage;
switch(lEvent)
{
// An image in the system image list has changed.
case SHCNE_UPDATEIMAGE:
{
hr = S_OK;
if (pidl2)
iImage = SHHandleUpdateImage(pidl2);
else
iImage = *(int UNALIGNED *)((BYTE *)pidl1 + 2);
if (iImage != -1)
{
// Process iImage as desired.
}
break;
}
// Other cases
}
return hr;
}
요구 사항
요구 사항 | 값 |
---|---|
지원되는 최소 클라이언트 | Windows XP [데스크톱 앱만 해당] |
지원되는 최소 서버 | Windows Server 2003 [데스크톱 앱만 해당] |
대상 플랫폼 | Windows |
헤더 | shlobj_core.h(Shlobj.h 포함) |
라이브러리 | Shell32.lib |
DLL | Shell32.dll(버전 5.0 이상) |
추가 정보
피드백
https://aka.ms/ContentUserFeedback
출시 예정: 2024년 내내 콘텐츠에 대한 피드백 메커니즘으로 GitHub 문제를 단계적으로 폐지하고 이를 새로운 피드백 시스템으로 바꿀 예정입니다. 자세한 내용은 다음을 참조하세요.다음에 대한 사용자 의견 제출 및 보기