Bagikan melalui

Fungsi SHGetAttributesFromDataObject (shlobj_core.h)

  • Artikel

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

Mengambil informasi tertentu dari objek data sistem.

Sintaks

HRESULT SHGetAttributesFromDataObject(
  [in, optional]  IDataObject *pdo,
                  DWORD       dwAttributeMask,
  [out, optional] DWORD       *pdwAttributes,
  [out, optional] UINT        *pcItems
);

Parameter

[in, optional] pdo

Jenis: IDataObject*

Objek data untuk mengambil informasi.

dwAttributeMask

Jenis: DWORD

Satu atau beberapa bendera SFGAO yang menunjukkan bagian informasi mana yang ingin diambil oleh aplikasi panggilan.

[out, optional] pdwAttributes

Jenis: DWORD*

Penunjuk ke nilai DWORD yang, ketika fungsi ini berhasil dikembalikan, menerima satu atau beberapa bendera SFGAO yang menunjukkan atribut, di antara yang diminta, yang umum untuk semua item dalam pdo. Penunjuk ini bisa NULL jika informasi ini tidak diperlukan.

[out, optional] pcItems

Jenis: UINT*

Penunjuk ke UINT yang, ketika fungsi ini berhasil dikembalikan, menerima jumlah PIDL dalam objek data yang ditujukkan oleh pdo. Penunjuk ini bisa NULL jika informasi ini tidak diperlukan.

Nilai kembali

Jenis: HRESULT

Fungsi ini dapat mengembalikan salah satu nilai ini.

Menampilkan kode Deskripsi
S_OK
 Berhasil.
S_FALSE
 Objek bukan objek data sistem. Dalam hal ini, pdwAttributes diatur ke 0.

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 shlobj_core.h (termasuk Shlobj.h)
Pustaka Shell32.lib
DLL Shell32.dll (versi 6.0 atau yang lebih baru)