IHolder::Metode TrackResource (comsvcs.h)

  • Artikel

Melacak sumber daya.

Sintaks

HRESULT TrackResource(
  [in] const RESID __MIDL__IHolder0003
);

Parameter

[in] __MIDL__IHolder0003

Handel sumber daya yang akan dilacak. Dispenser Sumber Daya telah membuat sumber daya ini sebelum memanggil TrackResource.

Nilai kembali

Metode ini dapat mengembalikan nilai berikut.

Menampilkan kode Deskripsi
S_OK
 Metode berhasil diselesaikan.
E_INVALIDARG
 ResId bukan handel sumber daya yang valid.
E_FAIL
Metode gagal. Sumber daya belum dilacak. Kemungkinan penyebabnya adalah transaksi penelepon dibatalkan.

Keterangan

Beberapa sumber daya tidak disimpan dalam inventori; mereka selalu diproduksi sesuai permintaan. Pemegang hanya digunakan sebagai mekanisme untuk secara otomatis membebaskan sumber daya yang tersisa di akhir masa pakai objek.

TrackResource memberi tahu Pemegang bahwa sumber daya harus dilacak hingga dibebaskan dengan memanggil IHolder::UntrackResource, atau sampai objek yang disebut TrackResource dirilis, pada saat itu Dispenser Manager secara otomatis membebaskan sumber daya.

Jika TrackResource dipanggil dari objek transaksi, TrackResource memanggil kembali ke metode IDispenserDriver::EnlistResource Resource Dispenser . Metode EnlistResource dapat mendaftarkan sumber daya dalam transaksi, atau dapat mengembalikan S_FALSE, menunjukkan bahwa sumber daya tidak mampu bertransaksi dan belum terdaftar.

Sumber daya ini akhirnya dihancurkan setelah kedua hal berikut ini benar:

  • Dispenser Sumber Daya memanggil IHolder::UntrackResource (kemungkinan besar pada permintaan komponen), atau masa pakai objek berakhir.
  • Transaksi tempat sumber daya terdaftar di (jika ada) dilakukan.

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

IDispenserManager

IHolder