Condividi tramite

Funzione SHCreateFileExtractIconW (shlobj_core.h)

  • Articolo

[SHCreateFileExtractIcon è disponibile per l'uso nei sistemi operativi specificati nella sezione Requisiti. Potrebbe essere modificato o non disponibile nelle versioni successive.]

Crea un gestore IExtractIcon predefinito per un oggetto file system. Le estensioni dello spazio dei nomi che visualizzano gli oggetti del file system usano in genere questa funzione. Gli attributi di estensione e file derivano tutto ciò che è necessario per un estrattore di icone semplice.

Sintassi

SHSTDAPI SHCreateFileExtractIconW(
  [in] LPCWSTR pszFile,
  [in] DWORD   dwFileAttributes,
  [in] REFIID  riid,
       void    **ppv
);

Parametri

[in] pszFile

Tipo: LPCTSTR

Puntatore a una stringa con terminazione Null che specifica l'oggetto file system. Il buffer non deve superare MAX_PATH caratteri di lunghezza.

[in] dwFileAttributes

Tipo: DWORD

Combinazione di uno o più flag di attributo di file (FILE_ATTRIBUTE_* valori definiti in Winnt.h) che specificano il tipo di oggetto.

[in] riid

Tipo: REFIID

Riferimento all'ID di interfaccia desiderato dell'interfaccia dell'estrattore icona da creare. Deve essere IID_IExtractIconA o IID_IExtractIconW.

ppv

Tipo: void**

Quando questa funzione viene restituita, contiene il puntatore di interfaccia richiesto in riid. Si tratta in genere di IExtractIcon.

Valore restituito

Tipo: HRESULT

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

Requisiti

Requisito Valore
Client minimo supportato Windows XP [solo app desktop]
Server minimo supportato Windows Server 2003 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione shlobj_core.h (includere Shlobj.h)
Libreria Shell32.lib
DLL Shell32.dll (versione 5.0 o successiva)