IPropertyNotifySink::OnRequestEdit, méthode (ocidl.h)
Avertit un récepteur qu’une propriété demandée est sur le point de changer.
Syntaxe
HRESULT OnRequestEdit(
[in] DISPID dispID
);
Paramètres
[in] dispID
Identificateur de répartition de la propriété sur le point de changer ou de DISPID_UNKNOWN si plusieurs propriétés sont sur le point de changer.
Valeur retournée
Cette méthode peut retourner les valeurs suivantes.
| Code de retour | Description |
|---|---|
|
La propriété ou les propriétés spécifiées sont autorisées à changer. |
|
La propriété ou les propriétés spécifiées ne sont pas autorisées à changer. L’appelant doit obéir à cette valeur de retour en supprimant la ou les nouvelles valeurs de propriété. Cela fait partie du contrat de l’attribut [demandéit] et de cette méthode. |
Remarques
Le récepteur peut choisir d’autoriser ou de interdire la modification à prendre. Par exemple, le récepteur peut appliquer un état en lecture seule sur la propriété. DISPID_UNKNOWN est un paramètre valide pour cette méthode pour indiquer que plusieurs propriétés sont sur le point de changer. Dans ce cas, le récepteur peut appliquer un état global en lecture seule pour toutes les propriétés [demandéit] dans l’objet, y compris les éléments spécifiques que le récepteur reconnaît sinon.
Si le récepteur autorise les modifications, l’objet doit également effectuer des notifications IPropertyNotifySink::OnChanged pour toutes les propriétés marquées [bindable] en plus de [demandéit].
Cette méthode ne peut pas être utilisée pour implémenter n’importe quelle sorte de validation des données. Au moment de l’appel, la nouvelle valeur souhaitée de la propriété n’est pas disponible et ne peut donc pas être validée. Cette méthode vise uniquement à autoriser le récepteur à appliquer un état en lecture seule sur une propriété.
Configuration requise
| Client minimal pris en charge | Windows 2000 Professionnel [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows 2000 Server [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | ocidl.h |