Método IPropertyPage::Apply (ocidl.h)

  • Artículo

Aplica los valores actuales a los objetos subyacentes asociados a la página de propiedades como se pasó anteriormente a IPropertyPage::SetObjects.

Sintaxis

HRESULT Apply();

Valor devuelto

Este método puede devolver los valores devueltos estándar E_OUTOFMEMORY y E_UNEXPECTED, así como los siguientes valores.

Código devuelto Descripción
S_OK
 Los cambios se aplicaron correctamente y la página de propiedades está actualizada con los objetos subyacentes.
S_FALSE
 Se aplicaron cambios, pero la página de propiedades no puede determinar si su estado es actual con los objetos .

Comentarios

Los objetos que se van a cambiar se proporcionan a través de una llamada anterior a IPropertyPage::SetObjects. Al llamar a IPropertyPage::SetObjects antes de llamar a este método, el autor de la llamada garantiza que todos los objetos subyacentes tengan las interfaces correctas a través de las cuales comunicar los cambios. Por lo tanto, este método no debe producir un error debido a interfaces inexistentes.

Después de aplicar sus valores, la página de propiedades debe determinar si su estado es ahora actual con los objetos para implementar correctamente IPropertyPage::IsPageDirty y proporcionar tanto S_OK como S_FALSE valores devueltos.

Notas para los implementadores

E_NOTIMPL no es un valor devuelto válido.

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

IPropertyPage