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

Notifica a un receptor que una propiedad requestedit está a punto de cambiar.

Sintaxis

HRESULT OnRequestEdit(
  [in] DISPID dispID
);

Parámetros

[in] dispID

Identificador de envío de la propiedad que está a punto de cambiar o DISPID_UNKNOWN si hay varias propiedades a punto de cambiar.

Valor devuelto

Este método puede devolver los valores siguientes.

Código devuelto	Descripción
S_OK	La propiedad o las propiedades especificadas pueden cambiar.
S_FALSE	No se permite cambiar la propiedad o las propiedades especificadas. El autor de la llamada debe obedecer este valor devuelto descartando los nuevos valores de propiedad. Esto forma parte del contrato del atributo [requestedit] y de este método.

Comentarios

El receptor puede optar por permitir o no permitir que se produzca el cambio. Por ejemplo, el receptor puede aplicar un estado de solo lectura en la propiedad . DISPID_UNKNOWN es un parámetro válido para este método para indicar que hay varias propiedades a punto de cambiar. En este caso, el receptor puede aplicar un estado global de solo lectura para todas las propiedades [requestedit] del objeto, incluidos los específicos que el receptor reconoce.

Si el receptor permite cambios, el objeto también debe realizar notificaciones IPropertyNotifySink::OnChanged para las propiedades marcadas como [enlazables] además de [requestedit].

Este método no se puede usar para implementar ningún tipo de validación de datos. En el momento de la llamada, el nuevo valor deseado de la propiedad no está disponible y, por tanto, no se puede validar. El único propósito de este método es permitir que el receptor aplique un estado de solo lectura en una propiedad.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	ocidl.h

Consulte también

IPropertyNotifySink