Metode IShellImageData::D ecode (shimgdata.h)

Artikel
03/02/2024

Mendekode file gambar, mengatur status.

Sintaks

HRESULT Decode(
  [in] DWORD dwFlags,
  [in] ULONG cxDesired,
  [in] ULONG cyDesired
);

Parameter

[in] dwFlags

Jenis: DWORD

Salah satu bendera berikut.

SHIMGDEC_DEFAULT (0x00)

Buat gambar lengkap.

SHIMGDEC_THUMBNAIL (0x01)

Dekode hanya gambar mini.

SHIMGDEC_LOADFULL (0x02)

Muat seluruh file gambar ke dalam memori.

[in] cxDesired

Jenis: ULONG

Ukuran horizontal yang diinginkan dari gambar yang didekodekan. Parameter ini hanya digunakan jika bendera SHIMGDEC_THUMBNAIL diatur. Jika bendera SHIMGDEC_DEFAULT diatur sebagai gantinya, nilai ini diabaikan.

[in] cyDesired

Jenis: ULONG

Ukuran vertikal yang diinginkan dari gambar yang didekodekan. Parameter ini hanya digunakan jika bendera SHIMGDEC_THUMBNAIL diatur. Jika bendera SHIMGDEC_DEFAULT diatur sebagai gantinya, nilai ini diabaikan.

Nilai kembali

Jenis: HRESULT

Mengembalikan S_OK jika berhasil, atau nilai kesalahan jika tidak, termasuk yang berikut ini:

Menampilkan kode	Deskripsi
E_FAIL	File tidak dapat dimuat atau aplikasi panggilan menghentikan proses dekode melalui panggilan ke IShellImageDataAbort terdaftar (lihat IShellImageData::RegisterAbort untuk informasi selengkapnya).
E_OUTOFMEMORY	Objek internal tidak dapat diinstansiasi.
E_NOTIMPL	Jalur yang digunakan untuk membuat instans IShellImageData ini adalah URL.
S_FALSE	Gambar telah didekodekan.

Keterangan

IShellImageData::D ecode harus dipanggil sebelum memanggil sebagian besar metode IShellImageData . Tidak melakukannya menyebabkan metode tersebut gagal.

IShellImageData::D ecode mencoba mempertahankan rasio aspek gambar asli, sehingga salah satu nilai yang diteruskan dalam cxDesired atau cyDesired mungkin ditimpa untuk melakukannya.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows XP [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Target Platform	Windows
Header	shimgdata.h
DLL	Shell32.dll

Bagikan melalui