CreatePointerMoniker

オブジェクトへのポインタに基づくポインタモニカを作成する。

CreatePointerMoniker punk, ppmk

punk : [var] 結果のモニカで識別するオブジェクト上の IUnknown インターフェイスへのポインタ。
ppmk : [var] 新しいポインタモニカへのインターフェイスポインタを受け取る IMoniker* ポインタ変数のアドレス。成功時、関数はモニカに対して AddRef を呼び出しており、呼び出し側が Release を呼び出す責任を負う。エラー発生時、返されるインターフェイスポインタの値は NULL となる。

(プラグイン / モジュール : ole32.dll)

解説

オブジェクトへのポインタに基づくポインタモニカを作成する。

[戻り値]
この関数は標準の戻り値 E_OUTOFMEMORY、E_UNEXPECTED、および S_OK を返すことがある。

[備考]

ポインタモニカは、既存のインターフェイスポインタを、モニカを必要とするインターフェイスに渡せるようにモニカでラップする。ポインタモニカを使用すると、永続的な表現を持たないオブジェクトであっても、モニカバインド操作に参加できる。
ポインタモニカはあまり使用されないため、この関数が呼び出されることはまれである。

情報