Metode IDispenserManager::RegisterDispenser (comsvcs.h)

  • Artikel

Mendaftarkan dispenser sumber daya dengan manajer dispenser.

Sintaks

HRESULT RegisterDispenser(
  [in]  IDispenserDriver *__MIDL__IDispenserManager0000,
  [in]  LPCOLESTR        szDispenserName,
  [out] IHolder          **__MIDL__IDispenserManager0001
);

Parameter

[in] __MIDL__IDispenserManager0000

Antarmuka IDispenserDriver yang ditawarkan Dispenser Sumber Daya ke Manajer Dispenser untuk digunakan nanti untuk memberi tahu Dispenser Sumber Daya.

[in] szDispenserName

Nama yang mudah diingat dari Resource Dispenser untuk tampilan administrator.

[out] __MIDL__IDispenserManager0001

Antarmuka IHolder yang telah dibuat untuk dispenser sumber daya.

Nilai kembali

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

Keterangan

Dispenser Sumber Daya memberi tahu Manajer Dispenser bahwa ia telah dimulai dan siap untuk menerima pemberitahuan pada antarmuka IDispenserDriver ini. Kemudian Manajer Dispenser membuat Pemegang untuk Dispenser Sumber Daya baru ini dan mengembalikannya ke Dispenser Sumber Daya.

Metode ini tidak memanggil AddRef pada objek pDispenserDriver , tetapi IHolder::Close melakukan Rilis di pDispenserDriver. Ini dapat menyebabkan objek Dispenser Sumber Daya dihancurkan sebelum waktunya. Untuk mencegah penghancuran dini ini, pemanggil IDispenserManager::RegisterDispenser harus secara eksplisit memanggil AddRef pada objek pDispenserDriver .

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

IDispenserManager