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 |
|---|---|
|
Änderungen wurden erfolgreich angewendet, und die Eigenschaftenseite ist mit den zugrunde liegenden Objekten aktuell. |
|
Ä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 |