Metode IROTData::GetComparisonData (objidl.h)

Mengambil data dari moniker yang dapat digunakan untuk menguji moniker untuk kesetaraan terhadap moniker lain.

Sintaks

HRESULT GetComparisonData(
  [out] byte  *pbData,
  [in]  ULONG cbMax,
  [out] ULONG *pcbData
);

Parameter

[out] pbData

Penunjuk ke buffer yang menerima data perbandingan.

[in] cbMax

Panjang buffer yang ditentukan dalam pbData.

[out] pcbData

Penunjuk ke variabel yang menerima panjang data perbandingan.

Nilai kembali

Metode ini dapat mengembalikan nilai pengembalian standar E_OUTOFMEMORY dan S_OK.

Keterangan

Metode GetComparisonData terutama dipanggil oleh tabel objek yang sedang berjalan (ROT). Data perbandingan yang dikembalikan oleh metode diuji untuk kesetaraan biner terhadap data perbandingan yang dikembalikan oleh moniker lain. Parameter pcbData memungkinkan ROT menemukan akhir data yang diambil.

Catatan untuk Pelaksana

Data perbandingan yang Anda kembalikan harus mengidentifikasi moniker secara unik, sambil tetap sesingkat mungkin. Data perbandingan harus mencakup informasi tentang status internal moniker, serta CLSID moniker. Misalnya, data perbandingan untuk moniker file akan menyertakan nama jalur yang disimpan dalam moniker, serta CLSID implementasi moniker file. Ini memungkinkan untuk membedakan dua moniker yang kebetulan menyimpan informasi status serupa tetapi merupakan instans dari kelas moniker yang berbeda.

Data perbandingan untuk moniker tidak boleh melebihi panjang 2048 byte. Untuk moniker komposit, panjang total data perbandingan untuk semua komponennya tidak boleh melebihi 2048 byte; akibatnya, jika moniker Anda dapat menjadi komponen dalam moniker komposit, data perbandingan yang Anda kembalikan harus secara signifikan kurang dari 2048 byte.

Jika data perbandingan Anda lebih panjang dari nilai yang ditentukan oleh parameter cbMax , Anda harus mengembalikan kesalahan. Perhatikan bahwa ketika GetComparisonData dipanggil pada komponen moniker komposit, nilai cbMax menjadi lebih kecil untuk setiap moniker secara berurutan.

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

IROTData