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

Aplica os valores atuais aos objetos subjacentes associados à página de propriedades, conforme passado anteriormente para IPropertyPage::SetObjects.

Sintaxe

HRESULT Apply();

Retornar valor

Esse método pode retornar os valores retornados padrão E_OUTOFMEMORY e E_UNEXPECTED, bem como os valores a seguir.

Código de retorno	Descrição
S_OK	As alterações foram aplicadas com êxito e a página de propriedades está atual com os objetos subjacentes.
S_FALSE	As alterações foram aplicadas, mas a página de propriedades não pode determinar se seu estado é atual com os objetos .

Comentários

Os objetos a serem alterados são fornecidos por meio de uma chamada anterior para IPropertyPage::SetObjects. Ao chamar IPropertyPage::SetObjects antes de chamar esse método, o chamador garante que todos os objetos subjacentes tenham as interfaces corretas para comunicar as alterações. Portanto, esse método não deve falhar devido a interfaces inexistentes.

Depois de aplicar seus valores, a página de propriedades deve determinar se seu estado agora está atual com os objetos para implementar corretamente IPropertyPage::IsPageDirty e fornecer S_OK eS_FALSE valores retornados.

Observações aos implementadores

E_NOTIMPL não é um valor retornado válido.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	ocidl.h

Confira também

Ipropertypage