IADsExtension 介面 (iads.h)
IADsExtension介面形成 ADSI 應用程式延伸模組模型的基礎。 它可讓獨立軟體廠商 (ISV) ,將應用程式特定行為,例如方法或函式新增至現有的 ADSI 物件。 多個廠商可以獨立擴充相同物件的功能,以執行類似但不相關的作業。
擴充模型是以 COM 中的匯總模型為基礎。 匯總工具或外部物件可以加入至其方法基底、匯總物件或內建物件的基底。 實作 IADsExtension 介面的 ADSI 擴充物件是匯總物件,而 ADSI 提供者則是匯總工具。
注意 實作擴充模組時,請在完成時釋放介面。 否則,即使不再需要,匯總工具也無法釋放介面。
- 擴充元件需要由 Operate方法中的dwCode所定義的初始化通知。 在此情況下,擴充用戶端必須呼叫 Operate 方法。 其他兩種方法,也就是PrivateInvoke和PrivateGetIDsOfNames,通常會在HRESULT值中傳回E_NOTIMPL。
- 擴充元件支援任何雙重或分派介面。 在此情況下,擴充用戶端必須呼叫 PrivateGetIDsOfNames 或 PrivateInvoke 方法。 操作通常會忽略資料,並在HRESULT值中傳回E_NOTIMPL。
繼承
IADsExtension介面繼承自IUnknown介面。 IADsExtension 也有下列類型的成員:
方法
IADsExtension介面具有這些方法。
IADsExtension::Operate 根據提供者的規格解譯控制項程式碼和輸入參數。 |
IADsExtension::P rivateGetIDsOfNames IADsExtension::P rivateGetIDsOfNames 方法是由 ADSI 匯總工具所呼叫,在 ADSI 判斷擴充功能是用來支援雙重或分派介面。 方法可以使用類型資料,使用 IDispatch::GetIDsOfNames 來取得 DISPID。 |
IADsExtension::P rivateInvoke IADsExtension::P rivateInvoke 方法通常由 ADSI 在 IADsExtension::P rivateGetIDsOfNames 方法之後呼叫。 這個方法可以有自訂實作,也可以將作業委派給 IDispatch::D ispInvoke 方法。 |
需求
最低支援的用戶端 | Windows Vista |
最低支援的伺服器 | Windows Server 2008 |
目標平台 | Windows |
標頭 | iads.h |