Metode IDispenserDriver::RateResource (comsvcs.h)

Artikel
08/22/2023

Mengevaluasi seberapa baik kecocokan sumber daya kandidat.

Sintaks

HRESULT RateResource(
  [in]  const RESTYPID ResTypId,
  [in]  const RESID    ResId,
  [in]  const BOOL     fRequiresTransactionEnlistment,
  [out] RESOURCERATING *pRating
);

Parameter

[in] ResTypId

Jenis sumber daya yang ingin dicocokkan oleh Manajer Dispenser.

[in] ResId

Sumber daya kandidat yang dipertimbangkan oleh Manajer Dispenser.

[in] fRequiresTransactionEnlistment

Jika TRUE, sumber daya kandidat (ResId), jika dipilih, memerlukan pendaftaran transaksi. Jika pendaftaran mahal, RateResource mungkin menilai sumber daya seperti itu lebih rendah dari sumber daya yang sudah terdaftar dalam transaksi yang benar.

[out] pRating

Peringkat Dispenser dari kandidat ini. Parameter ini bisa menjadi salah satu nilai berikut.

Nilai	Makna
0	Sumber daya kandidat tidak dapat digunakan untuk permintaan ini. Sumber daya tidak atau tidak dapat diubah menjadi tipe ResTypId.
1	Kandidatnya tidak cocok, tapi bisa digunakan. Manajer Dispenser akan terus menyarankan kandidat.
2	Kandidat lebih baik daripada kandidat yang dinilai 1. Manajer Dispenser akan terus menyarankan kandidat.
100	Kandidat sangat cocok. Manajer Dispenser akan berhenti menyarankan kandidat.

Nilai kembali

Jika metode berhasil, nilai yang dikembalikan adalah S_OK. Jika tidak, itu E_FAIL.

Keterangan

Jika fRequiresTransactionEnlistmentADALAH FALSE, objek dispensasi sumber daya ini dalam transaksi ini, objek yang digunakan dan kemudian membebaskan sumber daya (secara eksplisit atau implisit pada akhir masa pakai objek). Objek kedua dalam transaksi yang sama meminta sumber daya serupa, dan sumber daya yang dipertimbangkan oleh objek pertama yang digunakan. Sumber daya ini adalah kandidat yang baik karena sudah terdaftar dalam transaksi yang benar.

Jika jenis sumber daya tertentu hanya dapat digunakan sekali per transaksi, sumber daya yang telah digunakan sekali dalam transaksi dapat diidentifikasi oleh fRequiresTransactionEnlistmentfalse dan dapat ditolak untuk digunakan lebih lanjut dengan mengembalikan *pRating=0.

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	comsvcs.h

Lihat juga

IDispenserDriver

Bagikan melalui