SHChangeDWORDAsIDList 구조체(shlobj_core.h)

[SHChangeDWORDAsIDList 는 요구 사항 섹션에 지정된 운영 체제에서 사용할 수 있습니다. 이후 버전에서는 변경되거나 제공되지 않을 수 있습니다.]

SHChangeNotify에서 사용할 수 있도록 ITEMIDLIST를 모방하는 양식에 두 개의 DWORD 값을 저장합니다.

구문

typedef struct _SHChangeDWORDAsIDList {
  USHORT cb;
  DWORD  dwItem1;
  DWORD  dwItem2;
  USHORT cbZero;
} SHChangeDWORDAsIDList, *LPSHChangeDWORDAsIDList;

멤버

cb

형식: USHORT

구조체의 크기(바이트)입니다.

dwItem1

형식:DWORD

첫 번째 DWORD 값입니다.

dwItem2

형식:DWORD

두 번째 DWORD 값입니다.

cbZero

형식: USHORT

설명

이 예제에서는 SHChangeNotify에서 SHChangeUpdateImageIDList 및 SHChangeDWORDAsIDList를 사용하여 SHUpdateImage 함수를 모방하는 방법을 보여 줍니다.

void MyUpdateImage(LPCWSTR pszHashItem, int iIndex, UINT uFlags, int iImageIndex)
{
    SHChangeUpdateImageIDList rgPidl;
    SHChangeDWORDAsIDList rgDWord;
    int cchLen;
    USHORT *pcb;

    // Validate parameters: iImageIndex must be a valid system image list value.
    if (iImageIndex < 0)
    {
        return;
    }

    // Validate parameters: pszHashItem must not exceed MAX_PATH in length
    cchLen = lstrlenW(pszHashItem);
    if (cchLen >= MAX_PATH)
    {
        return;
    }

    // Load SHChangeUpdateImageIDList
    rgPidl.dwProcessID = GetCurrentProcessId();
    rgPidl.iIconIndex = iIndex;
    rgPidl.iCurIndex = iImageIndex;
    rgPidl.uFlags = uFlags;
    lstrcpynW(rgPidl.szName, pszHashItem, MAX_PATH);
    pcb = &rgPidl.szName[cchLen+1];
    
    // Set the size of the first element
    rgPidl.cb = (USHORT)((BYTE*)pcb - (BYTE*)rgPidl); 
    
    // Terminate the "ITEMIDLIST"
    *pcb = 0; 

    // Load SHChangeDWORDAsIDList
    rgDWord.cb = (USHORT)FIELD_OFFSET(SHChangeDWORDAsIDList, cbZero);
    rgDWord.dwItem1 = iImageIndex;
    rgDWord.dwItem2 = 0;
    rgDWord.cbZero = 0;

    // Parameters are now in the form that SHCNE_UPDATEIMAGE can accept
    SHChangeNotify(SHCNE_UPDATEIMAGE, SHCNF_IDLIST, &rgDWord, &rgPidl);
}

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows XP [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2003 [데스크톱 앱만 해당]
머리글	shlobj_core.h(Shlobj.h 포함)

추가 정보

SHChangeUpdateImageIDList