Méthode IPropertyNotifySink ::OnRequestEdit (ocidl.h)
Avertit un récepteur qu’une propriété requestedit 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 ou les propriétés spécifiées sont autorisées à changer. |
|
La ou les propriétés spécifiées ne sont pas autorisées à changer. L’appelant doit obéir à cette valeur de retour en ignorant la ou les nouvelles valeurs de propriété. Cela fait partie du contrat de l’attribut [requestedit] et de cette méthode. |
Remarques
Le récepteur peut choisir d’autoriser ou d’interdire la modification. 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 [requestedit] de l’objet, y compris celles spécifiques que le récepteur reconnaît par ailleurs.
Si le récepteur autorise les modifications, l’objet doit également effectuer des notifications IPropertyNotifySink ::OnChanged pour toutes les propriétés marquées [pouvant être liée] en plus de [requestedit].
Cette méthode ne peut pas être utilisée pour implémenter un quelconque type 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. Le seul objectif de cette méthode est de permettre au récepteur d’appliquer un état en lecture seule sur une propriété.
Configuration requise
| Condition requise | Valeur |
|---|---|
| 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 |