IPropertyPage::Apply 方法 (ocidl.h)
將目前值套用至與屬性頁相關聯的基礎物件,如先前傳遞至 IPropertyPage::SetObjects 一樣。
Syntax
HRESULT Apply();
傳回值
這個方法可以 傳回標準 傳回值E_OUTOFMEMORY和 E_UNEXPECTED,以及下列值。
傳回碼 | 描述 |
---|---|
|
已成功套用變更,而且屬性頁目前具有基礎物件。 |
|
已套用變更,但屬性頁無法判斷其狀態是否為物件目前狀態。 |
備註
要變更的對像是透過先前對 IPropertyPage::SetObjects 的呼叫來提供。 藉由在呼叫此方法之前呼叫 IPropertyPage::SetObjects ,呼叫端可確保所有基礎物件都有正確的介面,以便進行變更通訊。 因此,此方法不應該因為不存在的介面而失敗。
套用其值之後,屬性頁應該判斷其狀態目前是否為物件目前,以便正確實作 IPropertyPage::IsPageDirty ,並提供 S_OK 和 S_FALSE 傳回值。
實作者的注意事項
E_NOTIMPL不是有效的傳回值。規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows 2000 專業版 [僅限傳統型應用程式] |
最低支援的伺服器 | Windows 2000 Server [僅限傳統型應用程式] |
目標平台 | Windows |
標頭 | ocidl.h |