Méthode IPropertyNotifySink ::OnRequestEdit (ocidl.h)

  • Article

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
S_OK
 La ou les propriétés spécifiées sont autorisées à changer.
S_FALSE
 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

Voir aussi

IPropertyNotifySink