IDispenserManager::RegisterDispenser メソッド (comsvcs.h)

ディスペンサー マネージャーにリソース ディスペンサーを登録します。

構文

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

パラメーター

[in] __MIDL__IDispenserManager0000

リソース ディスペンサーが提供 する IDispenserDriver インターフェイスは、後でリソース ディスペンサーに通知するために使用するためにディスペンサー マネージャーに提供されます。

[in] szDispenserName

管理者用リソース ディスペンサーのフレンドリ名が表示されます。

[out] __MIDL__IDispenserManager0001

リソース ディスペンサー用にインスタンス化された IHolder インターフェイス。

戻り値

メソッドが成功した場合、戻り値はS_OK。 それ以外の場合は、E_FAIL。

注釈

リソース ディスペンサーは、起動し、この IDispenserDriver インターフェイスで通知を受け入れる準備ができていることをディスペンサー マネージャーに通知します。 その後、ディスペンサーマネージャーはこの新しいリソースディスペンサーのホルダーを作成し、それをリソースディスペンサーに返します。

このメソッドは pDispenserDriver オブジェクトの AddRef を呼び出しませんが、IHolder::Close は pDispenserDriver で Release を実行します。 これにより、リソース ディスペンサー オブジェクトが途中で破棄される可能性があります。 この早期破棄を防ぐために、IDispenserManager::RegisterDispenser の呼び出し元は、pDispenserDriver オブジェクトで AddRef を明示的に呼び出す必要があります。

要件

こちらもご覧ください

IDispenserManager