IPropertyPage::Apply メソッド (ocidl.h)

以前に IPropertyPage::SetObjects に渡されたプロパティ ページに関連付けられている基になるオブジェクトに現在の値を適用します。

構文

HRESULT Apply();

戻り値

このメソッドは、 E_OUTOFMEMORY および E_UNEXPECTED標準の戻り値と、次の値を返すことができます。

リターン コード	説明
S_OK	変更が正常に適用され、プロパティ ページは基になるオブジェクトの現在のページです。
S_FALSE	変更が適用されましたが、プロパティ ページはオブジェクトの状態が最新かどうかを判断できません。

注釈

変更するオブジェクトは、 IPropertyPage::SetObjects の以前の呼び出しによって提供されます。 このメソッドを呼び出す前に IPropertyPage::SetObjects を呼び出すことで、呼び出し元は、基になるすべてのオブジェクトが、変更を伝達するための正しいインターフェイスを持っていることを確認します。 したがって、存在しないインターフェイスのため、このメソッドは失敗しません。

値を適用した後、プロパティ ページは、 IPropertyPage::IsPageDirty を適切に実装し、 S_OK とS_FALSEの両方の戻り値を提供するために、その状態 が オブジェクトに対して現在の状態であるかどうかを判断する必要があります。

実装者へのメモ

E_NOTIMPLは有効な戻り値ではありません。

要件

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

こちらもご覧ください

IPropertyPage