IPropertyNotifySink::OnRequestEdit-Methode (ocidl.h)
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 |
|---|---|
|
Die angegebene Eigenschaft oder Eigenschaften dürfen sich ändern. |
|
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 |