ObjectExtenders.RegisterExtenderProviderUnk 方法

發行項
08/12/2011

登錄 IUnknown 架構擴充項分類的擴充性提供者。

命名空間： EnvDTE
組件： EnvDTE (在 EnvDTE.dll 中)

語法

'宣告
Function RegisterExtenderProviderUnk ( _
    ExtenderCATID As String, _
    ExtenderName As String, _
    ExtenderProvider As IExtenderProviderUnk, _
    LocalizedName As String _
) As Integer

int RegisterExtenderProviderUnk(
    string ExtenderCATID,
    string ExtenderName,
    IExtenderProviderUnk ExtenderProvider,
    string LocalizedName
)

int RegisterExtenderProviderUnk(
    [InAttribute] String^ ExtenderCATID, 
    [InAttribute] String^ ExtenderName, 
    [InAttribute] IExtenderProviderUnk^ ExtenderProvider, 
    [InAttribute] String^ LocalizedName
)

abstract RegisterExtenderProviderUnk : 
        ExtenderCATID:string * 
        ExtenderName:string * 
        ExtenderProvider:IExtenderProviderUnk * 
        LocalizedName:string -> int

function RegisterExtenderProviderUnk(
    ExtenderCATID : String, 
    ExtenderName : String, 
    ExtenderProvider : IExtenderProviderUnk, 
    LocalizedName : String
) : int

參數

ExtenderCATID
型別：System.String
必要項。擴充項 CATID。

ExtenderName
型別：System.String
必要項。擴充項名稱。這是擴充項的程式設計名稱，使用於對 GetExtender 的呼叫中。

ExtenderProvider
型別：EnvDTE.IExtenderProviderUnk
必要項。實作 IExtenderProviderUnk 介面的擴充性提供者。

LocalizedName
型別：System.String
選擇項。擴充項的當地語系化顯示名稱。

傳回值

型別：System.Int32
識別註冊的整數值 Cookie。在 UnregisterExtenderProvider 期間必須傳回這個 Cookie。

備註

RegisterExtenderProviderUnk 為以 IUnknown 為基礎之擴充性提供者使用，透過動態方式，將自身以特定 CATID 和名稱向 ObjectExtenders 物件進行登錄。擴充性提供者可在一或多個 CATID 之下登錄超過一個擴充項。

有兩種方法可登錄擴充性提供者：

第一種為靜態方式，是在安裝增益集期間，在 HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\VisualStudio\8.0\Extenders 登錄機碼之下的適當擴充項 CATID 子機碼中登錄。

第二種為動態方式，是在增益集的 OnConnection 方法中呼叫此方法以進行登錄。

注意事項
以動態方式登錄的擴充性提供者，必須在關機時呼叫 UnregisterExtenderProvider，以解除登錄自身。以靜態方式登錄的提供者並不需要這樣做。