IPropertyNotifySink::OnRequestEdit 方法 (ocidl.h)
通知接收, requestedit 屬性即將變更。
語法
HRESULT OnRequestEdit(
[in] DISPID dispID
);
參數
[in] dispID
即將變更或DISPID_UNKNOWN多個屬性即將變更的屬性分派標識碼。
傳回值
這個方法可以傳回下列值。
傳回碼 | 描述 |
---|---|
|
允許變更指定的屬性或屬性。 |
|
不允許變更指定的屬性或屬性。 呼叫端必須捨棄新的屬性值, (s) 來遵守這個傳回值。 這是 [requestedit] 屬性和這個方法合約的一部分。 |
備註
接收可以選擇允許或不允許進行變更。 例如,接收可能會在 屬性上強制執行只讀狀態。 DISPID_UNKNOWN是這個方法的有效參數,表示多個屬性即將變更。 在此情況下,接收可以針對 物件中的所有 [requestedit] 屬性強制執行全域只讀狀態,包括接收所辨識的任何特定屬性。
如果接收允許變更,除了 [requestedit] 之外,對象也必須針對任何標示為 [bindable] 的屬性發出 IPropertyNotifySink::OnChanged 通知。
這個方法無法用來實作任何類型的數據驗證。 在呼叫時,屬性所需的新值無法使用,因此無法驗證。 這個方法的唯一用途是允許接收在屬性上強制執行只讀狀態。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows 2000 Professional [僅限傳統型應用程式] |
最低支援的伺服器 | Windows 2000 Server [僅限桌面應用程式] |
目標平台 | Windows |
標頭 | ocidl.h |