OleNoteObjectVisible 関数 (ole2.h)
オブジェクトを実行中の状態に保つ外部参照をインクリメントまたはデクリメントします。
構文
HRESULT OleNoteObjectVisible(
[in] LPUNKNOWN pUnknown,
[in] BOOL fVisible
);
パラメーター
[in] pUnknown
ロックまたはロック解除されるオブジェクトの IUnknown インターフェイスへのポインター。
[in] fVisible
オブジェクトが表示されるかどうか。 TRUE の場合、OLE は参照カウントをインクリメントして、外部または内部の IUnknown::AddRef および IUnknown::Release 操作、登録、または失効に関係なく、オブジェクトが表示され、有効な状態を保持します。 FALSE の場合、OLE はホールドを解放し (参照カウントをデクリメント)、オブジェクトを閉じることができます。
戻り値
この関数は、成功したS_OKを返します。 その他の使用可能な値は次のとおりです。
リターン コード | 説明 |
---|---|
|
操作のメモリが不足しています。 |
|
1 つ以上のパラメーターが無効です。 |
|
予期しないエラーが発生しました。 |
注釈
OleNoteObjectVisible 関数は、CoLockObjectExternal 関数を呼び出します。 オブジェクトがユーザーに表示された場合にオブジェクトをロックする必要性を強化し、非表示になったときにオブジェクトを解放する別の関数として提供されます。 これにより、ユーザーに代わって強力なロックが作成され、オブジェクトが表示されている間、コンテナーでオブジェクトを閉じることができません。
要件
要件 | 値 |
---|---|
サポートされている最小のクライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリのみ] |
対象プラットフォーム | Windows |
ヘッダー | ole2.h |
Library | Ole32.lib |
[DLL] | Ole32.dll |