Bagikan melalui

Antarmuka IIdentityName (shobjidl_core.h)

  • Artikel

Mengekspos metode untuk membandingkan dua item untuk melihat apakah keduanya sama.

Warisan

Antarmuka IIdentityName mewarisi dari antarmuka IRelatedItem.

Keterangan

Antarmuka ini hanya menyediakan metode antarmuka IRelatedItem , dari mana ia mewarisi.

Sumber data shell yang menyajikan item di lokasi virtual, seperti hasil pencarian, biasanya mengimplementasikan antarmuka ini sebagai handler untuk menemukan lokasi item yang sebenarnya—untuk menemukan folder yang berisi file. Misalnya, antarmuka ini digunakan untuk mengimplementasikan perintah Buka Lokasi File di Windows Explorer. Saat pengguna mengklik kanan file dalam sekumpulan hasil pencarian, misalnya, lalu memilih Buka Lokasi File, perintah menggunakan IIdentityName untuk mendapatkan item yang benar dan membuka browser di induknya (folder file) alih-alih membuka induk item (yang sudah menjadi tempat pengguna berada).

Beberapa kontrol (tombol Mulai pada taskbar, dan kontrol namespace) menggunakan IIdentityName untuk mendapatkan item asli dan dengan demikian menghindari item duplikat.

Antarmuka ini berguna dengan daftar ID alias (ketik ITEMIDLIST), seperti yang dapat ditunjukkan menggunakan dua daftar berikut.

  1. [komputer] [c:] [pengguna] [ pat ] [desktop] [myfile.txt]. Ini adalah file di desktop pengguna dan ditangani oleh implementasi IShellFolder di Windows Vista yang menangani sistem file.
  2. [desktop] [myfile.txt]. Implementasi IShellFolder di belakang desktop menunjukkan file dari desktop pengguna, semua desktop pengguna, dan beberapa item khusus seperti Keranjang Sampah. Ketika diminta untuk mengikat melalui IShellFolder::BindToObject menggunakan IID IID_IIdentityName, IShellFolder ini mengembalikan item yang mendasar, yang merupakan item folder file tepat di atas.
Catatan Untuk mendapatkan instans handler ini, gunakan IShellFolder::BindToObject dengan IID_IIdentityItem atau gunakan IShellItem::BindToHandler dengan BHID_SFObject.
 

Persyaratan

   
Klien minimum yang didukung Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung Windows Server 2008 [hanya aplikasi desktop]
Target Platform Windows
Header shobjidl_core.h