IPropertyPage::Apply-Methode (ocidl.h)

Wendet die aktuellen Werte auf die zugrunde liegenden Objekte an, die der Eigenschaftenseite zugeordnet sind, wie zuvor an IPropertyPage::SetObjects übergeben.

Syntax

HRESULT Apply();

Rückgabewert

Diese Methode kann die standardmäßigen Rückgabewerte E_OUTOFMEMORY und E_UNEXPECTED sowie die folgenden Werte zurückgeben.

Rückgabecode BESCHREIBUNG
S_OK
Änderungen wurden erfolgreich angewendet, und die Eigenschaftenseite ist mit den zugrunde liegenden Objekten aktuell.
S_FALSE
Änderungen wurden angewendet, aber die Eigenschaftenseite kann nicht bestimmen, ob ihr Zustand mit den -Objekten aktuell ist.

Hinweise

Die zu ändernden Objekte werden über einen vorherigen Aufruf von IPropertyPage::SetObjects bereitgestellt. Durch den Aufruf von IPropertyPage::SetObjects vor dem Aufrufen dieser Methode stellt der Aufrufer sicher, dass alle zugrunde liegenden Objekte über die richtigen Schnittstellen verfügen, über die Änderungen kommuniziert werden können. Daher sollte diese Methode nicht aufgrund nicht vorhandener Schnittstellen fehlschlagen.

Nach dem Anwenden der Werte sollte die Eigenschaftenseite bestimmen, ob ihr Zustand jetzt mit den -Objekten aktuell ist, um IPropertyPage::IsPageDirty ordnungsgemäß zu implementieren und sowohl S_OK als auch S_FALSE Rückgabewerte bereitzustellen.

Hinweise für Implementierer

E_NOTIMPL ist kein gültiger Rückgabewert.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile ocidl.h

Weitere Informationen

IPropertyPage