IMoniker::Metode hash (objidl.h)

Membuat nilai hash menggunakan status internal moniker.

Sintaks

HRESULT Hash(
  [out] DWORD *pdwHash
);

Parameter

[out] pdwHash

Penunjuk ke variabel yang menerima nilai hash.

Nilai kembali

Metode ini mengembalikan S_OK untuk menunjukkan bahwa nilai hash berhasil diambil.

Keterangan

Catatan untuk Penelepon

Anda dapat menggunakan nilai yang dikembalikan oleh metode ini untuk mempertahankan tabel hash moniker. Nilai hash menentukan wadah hash dalam tabel. Untuk mencari tabel seperti itu untuk moniker tertentu, hitung nilai hash-nya lalu bandingkan dengan moniker dalam wadah hash tersebut menggunakan IMoniker::IsEqual.

Catatan untuk Pelaksana

Nilai hash harus konstan selama masa pakai moniker. Dua moniker yang membandingkan sama dengan menggunakan IMoniker::IsEqual harus hash dengan nilai yang sama.

Marshaling dan kemudian membatalkan nama moniker seharusnya tidak berpengaruh pada nilai hash-nya. Akibatnya, implementasi IMoniker::Hash Anda harus hanya mengandalkan status internal moniker, bukan pada alamat memorinya.

Catatan khusus implementasi

Implementasi	Catatan
Anti-moniker	Metode ini menghitung nilai hash untuk moniker.
Moniker kelas	Metode ini menghitung nilai hash untuk moniker dan mengembalikan S_OK. Dapat mengembalikan E_INVALIDARG jika pdwHash adalah penunjuk yang tidak valid.
Moniker file	Metode ini menghitung nilai hash untuk moniker.
Moniker komposit generik	Metode ini menghitung nilai hash untuk moniker.
Moniker item	Metode ini menghitung nilai hash untuk moniker.
Moniker OBJREF	Metode ini menghitung nilai hash untuk moniker.
Penunjuk moniker	Metode ini menghitung nilai hash untuk moniker.
Moniker URL	Membuat nilai hash berdasarkan string URL moniker. Nilai hash ini identik ketika string URL identik, meskipun mungkin juga identik untuk string URL yang berbeda. Metode ini digunakan untuk mempercepat perbandingan dengan mengurangi jumlah waktu yang diperlukan untuk memanggil IMoniker::IsEqual.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Target Platform	Windows
Header	objidl.h

Lihat juga

IMoniker