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