共用方式為


IPropertyNotifySink::OnRequestEdit 方法 (ocidl.h)

通知接收, requestedit 屬性即將變更。

語法

HRESULT OnRequestEdit(
  [in] DISPID dispID
);

參數

[in] dispID

即將變更或DISPID_UNKNOWN多個屬性即將變更的屬性分派標識碼。

傳回值

這個方法可以傳回下列值。

傳回碼 描述
S_OK
允許變更指定的屬性或屬性。
S_FALSE
不允許變更指定的屬性或屬性。 呼叫端必須捨棄新的屬性值, (s) 來遵守這個傳回值。 這是 [requestedit] 屬性和這個方法合約的一部分。

備註

接收可以選擇允許或不允許進行變更。 例如,接收可能會在 屬性上強制執行只讀狀態。 DISPID_UNKNOWN是這個方法的有效參數,表示多個屬性即將變更。 在此情況下,接收可以針對 物件中的所有 [requestedit] 屬性強制執行全域只讀狀態,包括接收所辨識的任何特定屬性。

如果接收允許變更,除了 [requestedit] 之外,對象也必須針對任何標示為 [bindable] 的屬性發出 IPropertyNotifySink::OnChanged 通知。

這個方法無法用來實作任何類型的數據驗證。 在呼叫時,屬性所需的新值無法使用,因此無法驗證。 這個方法的唯一用途是允許接收在屬性上強制執行只讀狀態。

規格需求

需求
最低支援的用戶端 Windows 2000 Professional [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限桌面應用程式]
目標平台 Windows
標頭 ocidl.h

另請參閱

IPropertyNotifySink