Metodo IPropertyPage::Apply (ocidl.h)

Applica i valori correnti agli oggetti sottostanti associati alla pagina delle proprietà come passato in precedenza a IPropertyPage::SetObjects.

Sintassi

HRESULT Apply();

Valore restituito

Questo metodo può restituire i valori restituiti standard E_OUTOFMEMORY e E_UNEXPECTED, nonché i valori seguenti.

Codice restituito Descrizione
S_OK
Le modifiche sono state applicate correttamente e la pagina delle proprietà è corrente con gli oggetti sottostanti.
S_FALSE
Sono state applicate modifiche, ma la pagina delle proprietà non è in grado di determinare se lo stato è corrente con gli oggetti .

Commenti

Gli oggetti da modificare vengono forniti tramite una chiamata precedente a IPropertyPage::SetObjects. Chiamando IPropertyPage::SetObjects prima di chiamare questo metodo, il chiamante garantisce che tutti gli oggetti sottostanti abbiano le interfacce corrette tramite cui comunicare le modifiche. Pertanto, questo metodo non deve avere esito negativo a causa di interfacce inesistenti.

Dopo aver applicato i valori, la pagina delle proprietà deve determinare se lo stato è ora corrente con gli oggetti per implementare correttamente IPropertyPage::IsPageDirty e per fornire valori restituiti sia S_OK che S_FALSE .

Note per gli implementatori

E_NOTIMPL non è un valore restituito valido.

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

Ipropertypage