Fungsi SHCreateFileExtractIconA (shlobj_core.h)

[SHCreateFileExtractIcon tersedia untuk digunakan dalam sistem operasi yang ditentukan di bagian Persyaratan. Ini mungkin diubah atau tidak tersedia dalam versi berikutnya.]

Membuat handler IExtractIcon default untuk objek sistem file. Ekstensi namespace yang menampilkan objek sistem file biasanya menggunakan fungsi ini. Atribut ekstensi dan file memperoleh semua yang diperlukan untuk ekstraktor ikon sederhana.

Sintaks

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

Parameter

[in] pszFile

Jenis: LPCTSTR

Penunjuk ke string yang dihentikan null yang menentukan objek sistem file. Panjang buffer tidak boleh melebihi MAX_PATH karakter.

[in] dwFileAttributes

Jenis: DWORD

Kombinasi satu atau beberapa bendera atribut file (FILE_ATTRIBUTE_* nilai seperti yang didefinisikan dalam Winnt.h) yang menentukan jenis objek.

[in] riid

Jenis: REFIID

Referensi ke ID antarmuka yang diinginkan dari antarmuka ekstraktor ikon untuk dibuat. Ini harus IID_IExtractIconA atau IID_IExtractIconW.

ppv

Jenis: void**

Ketika fungsi ini kembali, berisi pointer antarmuka yang diminta dalam riid. Ini biasanya IExtractIcon.

Nilai kembali

Jenis: HRESULT

Jika fungsi ini berhasil, fungsi akan mengembalikan S_OK. Jika tidak, kode kesalahan HRESULT akan dikembalikan.

Persyaratan

Klien minimum yang didukung	Windows XP [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Target Platform	Windows
Header	shlobj_core.h (termasuk Shlobj.h)
Pustaka	Shell32.lib
DLL	Shell32.dll (versi 5.0 atau yang lebih baru)