Metodo IPropertyNotifySink::OnRequestEdit (ocidl.h)

Notifica a un sink che una proprietà requestedit sta per modificare.

Sintassi

HRESULT OnRequestEdit(
  [in] DISPID dispID
);

Parametri

[in] dispID

Identificatore di invio della proprietà che sta per modificare o DISPID_UNKNOWN se più proprietà stanno per modificare.

Valore restituito

Questo metodo può restituire i valori seguenti.

Codice restituito	Descrizione
S_OK	Le proprietà o le proprietà specificate sono consentite per modificare.
S_FALSE	La proprietà o le proprietà specificate non possono modificare. Il chiamante deve obbedire a questo valore restituito rimuovendo i nuovi valori di proprietà. Fa parte del contratto dell'attributo [requestedit] e questo metodo.

Commenti

Il sink può scegliere di consentire o impedire che venga eseguita la modifica. Ad esempio, il sink può applicare uno stato di sola lettura nella proprietà. DISPID_UNKNOWN è un parametro valido per questo metodo per indicare che più proprietà stanno per modificare. In questo caso, il sink può applicare uno stato di sola lettura globale per tutte le proprietà [requestedit] nell'oggetto, incluse quelle specifiche che il sink riconosce in caso contrario.

Se il sink consente modifiche, l'oggetto deve anche apportare notifiche IPropertyNotifySink::OnChanged per le proprietà contrassegnate [associabili] oltre a [requestedit].

Questo metodo non può essere usato per implementare qualsiasi tipo di convalida dei dati. Al momento della chiamata, il nuovo valore desiderato della proprietà non è disponibile e pertanto non può essere convalidato. Questo metodo consente al sink di applicare uno stato di sola lettura a una proprietà.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	ocidl.h

Vedi anche

Ipropertynotifysink