解決延伸模組中自動化中的函式/屬性名稱衝突

在本主題中，“object” 會以 ADSI 用戶端檢視物件的方式表示對象整體。 也就是說，ADSI 及其所有擴充功能。

具有相同參數的相同函式名稱

如果物件中的兩個以上的雙重 IDispatch 介面支援相同名稱的屬性或方法，例如，Func1，則會使用下列準則來判斷調用。 如果用戶端有一個雙介面的指標，該介面支援稱為 Func1 的方法，而且如果自動化環境支援 vtable 存取，Func1 會透過 ADSI vtable 存取直接叫用。

如果上述任一條件為 false，IDispatch：：GetIDsOfNames，並呼叫 IDispatch：：Invoke 來叫用 Func1。

如需詳細資訊和用戶端如何將指標新增至雙重介面的簡短說明，以及支援 vtable 存取的環境類型描述，請參閱 ADSI 延伸模組模型中的晚期系結與 Vtable 存取 。

由於所有擴充對象都會將 IDispatch 函式重新導向回匯總工具，因此會叫用 Func1 的匯總工具。 規則如下：

• 如果有任何介面，而且在匯總工具 （ADSI） 中只支援稱為 Func1的函式，匯總工具會叫用自己的 Func1。
• 否則，匯總工具會依照登錄中所列的順序，逐一查看其每個延伸模組，並尋找第一個延伸模組，其會實作名為 Func1 的函式。 第一個延伸模組中的多個雙重 IDispatch 介面有可能具有稱為 Func1的函式。 延伸模組必須決定應該一律在自動化中叫用哪些 Func1。

具有不同參數的相同函式名稱

上一節討論如何解決函式名稱衝突，也就是在自動化中發生函式名稱時，具有相同函式名稱和相同參數清單的函式名稱，例如數位、類型和順序。 如果兩個函式的名稱相同，但參數不同，該怎麼辦？ 如果 ADSI 用戶端使用 IDispatch：：GetIDsOfNames 叫用函式，而不使用多個名稱來指定參數，ADSI 擴充功能模型就無法釐清函式。 根據上述所討論的解析配置，透過其中一個介面支援此函式的登錄中的第一個延伸模組會叫用此函式的版本，而且呼叫可能會失敗或產生不正確的結果。

例如：

• Extn1 （第一個位於類別 CA 下的登錄 – 較高優先順序） 支援 IInterface1。
• Extn2 （類別 CA 下的第三個 – 優先順序較低） 支援 IInterface2。
• IInterface1 支援 Method1（int param1， int param2）。
• IInterface2 支援 Method1（int param1）。

ADSI 用戶端具有類別 CA 物件的 IDispatch 介面指標。 它想要叫用 IInterface2：：Method1 。 如果用戶端呼叫 「pDispatch->GetIDsOfNames（IID_NULL， rgszNames， 1， MY_LCID， rgDispId）“ 只要將函式名稱 ”Method1“ 儲存在 rgszNames[0]，然後 IInterface1：：Method1，而不是叫用所需的 IInterface2：：Method1，函式會失敗，因為參數數目不同。

為了將這個問題降到最低，延伸模塊開發人員可以使用自己的特定標識元為其函式名稱加上前置詞，並避免使用相同名稱但不同參數的介面設計。

如果發生名稱衝突，則如果介面是雙重介面，ADSI 用戶端可以透過直接 Vtable 存取來避免問題。 如果無法直接存取 vtable，ADSI 用戶端應該使用多個名稱呼叫 IDispatch：：GetIDsOfNames，並指定函式名稱和陣列中的參數，rgszNames 先前所述的參數。

Visual Basic 5 不會使用多個名稱呼叫 IDispatch：：GetIDsOfNames 函式。 也就是說，它只會將函式名稱傳遞至 GetIDsOfNames，但不會傳遞自變數。 不過，Visual Basic 5 可讓使用者透過直接 vtable 存取來叫用函式，而不是在介面是雙重介面時叫用 IDispatch：：GetIDsOfNames 函式。 開發人員應盡可能使用直接 Vtable 存取。

如需名稱衝突解決的詳細資訊，請參閱 解決函式名稱衝突的範例。