IOleControl::OnAmbientPropertyChange メソッド (ocidl.h)

  • [アーティクル]

1 つまたは複数のコンテナーのアンビエント プロパティが変更されたことをコントロールに通知します。

構文

HRESULT OnAmbientPropertyChange(
  [in] DISPID dispID
);

パラメーター

[in] dispID

変更されたアンビエント プロパティのディスパッチ識別子。 このパラメーターがDISPID_UNKNOWN場合は、複数のプロパティが変更されたことを示します。 この場合、コントロールは、現在の値を取得するために、対象となるすべてのアンビエント プロパティをチェックする必要があります。

戻り値

このメソッドは、すべてのケースでS_OKを返します。

注釈

実装者へのメモ

S_OKは、コントロールがアンビエント プロパティをサポートしていない場合や、他のエラーが発生した場合でも、すべての場合に返されます。 通知を送信する呼び出し元は、エラー コード (E_NOTIMPL など) を使用して、今後通知を送信するかどうかを判断しようとすることはできません。 このようなセマンティクスは、このインターフェイスの一部ではありません。

要件

要件 値
サポートされている最小のクライアント Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows 2000 Server [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー ocidl.h

こちらもご覧ください

IOleControl