IPropertyNotifySink::OnRequestEdit-Methode (ocidl.h)

  • Artikel

Benachrichtigt eine Senke, dass sich eine requestedit-Eigenschaft ändert.

Syntax

HRESULT OnRequestEdit(
  [in] DISPID dispID
);

Parameter

[in] dispID

Der Verteilerbezeichner der Eigenschaft, die sich ändern oder DISPID_UNKNOWN, wenn sich mehrere Eigenschaften ändern werden.

Rückgabewert

Diese Methode kann die folgenden Werte zurückgeben.

Rückgabecode BESCHREIBUNG
S_OK
 Die angegebene Eigenschaft oder Eigenschaften dürfen sich ändern.
S_FALSE
 Die angegebene Eigenschaft oder Eigenschaften dürfen sich nicht ändern. Der Aufrufer muss diesem Rückgabewert gehorchen, indem er die neuen Eigenschaftswerte verwirft. Dies ist Teil des Vertrags des [requestedit]-Attributs und dieser Methode.

Hinweise

Die Senke kann die Änderung zulassen oder nicht zulassen. Beispielsweise kann die Senke einen schreibgeschützten Zustand für die Eigenschaft erzwingen. DISPID_UNKNOWN ist ein gültiger Parameter für diese Methode, um anzugeben, dass sich mehrere Eigenschaften ändern werden. In diesem Fall kann die Senke einen globalen schreibgeschützten Zustand für alle [requestedit]-Eigenschaften im Objekt erzwingen, einschließlich aller spezifischen Eigenschaften, die die Senke andernfalls erkennt.

Wenn die Senke Änderungen zulässt, muss das Objekt auch IPropertyNotifySink::OnChanged-Benachrichtigungen für alle Eigenschaften vornehmen, die zusätzlich zu [requestedit] gekennzeichnet sind.

Diese Methode kann nicht zum Implementieren einer Datenüberprüfung verwendet werden. Zum Zeitpunkt des Aufrufs ist der gewünschte neue Wert der Eigenschaft nicht verfügbar und kann daher nicht überprüft werden. Diese Methode dient nur dazu, der Senke das Erzwingen eines schreibgeschützten Zustands für eine Eigenschaft zu ermöglichen.

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

Ipropertynotifysink