OleNoteObjectVisible

オブジェクトを実行状態に保つ外部参照をインクリメントまたはデクリメントする。

OleNoteObjectVisible pUnknown, fVisible

pUnknown : [var] ロックまたはアンロックするオブジェクト上の IUnknown インターフェイスへのポインタ。
fVisible : [int] オブジェクトが可視かどうか。TRUE の場合、外部または内部の IUnknown::AddRef や IUnknown::Release 操作、登録、取り消しに関係なく、オブジェクトを可視で生かしておくため、OLE は参照カウントをインクリメントする。FALSE の場合、OLE はその保持を解放（参照カウントをデクリメント）し、オブジェクトを閉じることができる。

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

解説

オブジェクトを実行状態に保つ外部参照をインクリメントまたはデクリメントする。

[戻り値]
関数が成功した場合は S_OK を返す。その他に返される値は以下のとおり。
（以下省略）

[備考]
OleNoteObjectVisible 関数は CoLockObjectExternal
関数を呼び出す。これは、オブジェクトがユーザに見えるようになったときにロックする必要性と、見えなくなったときに解放する必要性を強調するために独立した関数として提供されている。これにより、可視である間にコンテナによってオブジェクトが閉じられないようにユーザに代わって強いロックを作成する。

情報