Funzione SHCreateDefaultExtractIcon (shobjidl_core.h)

Articolo
08/26/2023

Crea un estrattore di icone standard, le cui impostazioni predefinite possono essere ulteriormente configurate tramite l'interfaccia IDefaultExtractIconInit .

Sintassi

HRESULT SHCreateDefaultExtractIcon(
        REFIID riid,
  [out] void   **ppv
);

Parametri

riid

Tipo: REFIID

Riferimento all'ID interfaccia.

[out] ppv

Tipo: void**

Indirizzo del puntatore dell'interfaccia IDefaultExtractIconInit .

Valore restituito

Tipo: HRESULT

Se questa funzione ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

L'utilizzo previsto per questa funzione è il seguente:

IExtractIcon *pxi;

IDefaultExtractIconInit *pdxi;

HRESULT hr = SHCreateDefaultExtractIcon(IID_PPV_ARGS(&pdxi);

 if (SUCCEEDED(hr)) &&

      SUCCEEDED(hr = pdxi->SetFlags(GIL_PERCLASS)) &&

      SUCCEEDED(hr = pdxi->SetKey(hkey)) &&   // optional

      SUCCEEDED(hr = pdxi->SetNormalIcon(L"this.dll", 1)) &&

      SUCCEEDED(hr = pdxi->SetOpenIcon(NULL, SIID_FOLDEROPEN)) && // optional

      SUCCEEDED(hr = pdxi->SetDefaultIcon(NULL, SIID_FOLDER)) && // optional

      SUCCEEDED(hr = pdxi->SetShortcutIcon(L"this.dll", 2))) // optional

{

      hr = pdxi->QueryInterface(IID_PPV_ARGS(&pxi)) 

}

 if (pdxi)

{

    pdxi->Release();

}

Requisiti


Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	shobjidl_core.h (include Shobjidl.h)
DLL	Shell32.dll
Set di API	ext-ms-win-shell-shell32-l1-2-1 (introdotta in Windows 10, versione 10.0.10240)

Condividi tramite