Funzione SHCreateFileExtractIconA (shlobj_core.h)

[SHCreateFileExtractIcon è disponibile per l'uso nei sistemi operativi specificati nella sezione Requisiti. Può 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 oggetti 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 SHCreateFileExtractIconA(
  [in] LPCSTR 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 in lunghezza.

[in] dwFileAttributes

Tipo: DWORD

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

[in] riid

Tipo: REFIID

Riferimento all'ID dell'interfaccia di estrazione dell'icona desiderata da creare. Questo deve essere IID_IExtractIconA o IID_IExtractIconW.

ppv

Tipo: void**

Quando questa funzione restituisce, contiene il puntatore dell'interfaccia richiesto in riid. Questo è in genere IExtractIcon.

Valore restituito

Tipo: HRESULT

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

Requisiti