Metodo ObjectExtenders.RegisterExtenderProviderUnk

Articolo
08/11/2011

Registra un provider Extender per una categoria di estensione basata su IUnknown.

Spazio dei nomi: EnvDTE
Assembly: EnvDTE (in EnvDTE.dll)

Sintassi

'Dichiarazione
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

Parametri

ExtenderCATID
Tipo: System.String
Obbligatorio.Il CATID dell'estensione.

ExtenderName
Tipo: System.String
Obbligatorio.Il nome dell'Extender.Si tratta del nome a livello di codice dell'Extender e viene utilizzato nella chiamata a GetExtender.

ExtenderProvider
Tipo: EnvDTE.IExtenderProviderUnk
Obbligatorio.Provider Extender che implementa l'interfaccia IExtenderProviderUnk.

LocalizedName
Tipo: System.String
Facoltativo.Il nome localizzato che viene visualizzato per l'estensione.

Valore restituito

Tipo: System.Int32
Cookie con valore intero che identifica la registrazione.Questo cookie deve essere restituito durante UnregisterExtenderProvider.

Note

RegisterExtenderProviderUnk viene utilizzato dal provider Extender basato su IUnknown per registrarsi dinamicamente sotto un CATID e un nome particolari con l'oggetto ObjectExtenders. Un provider Extender consente la registrazione di più oggetti Extender sotto uno o più CATID.

È possibile registrare i provider Extender in due modi diversi:

In modo statico, nella sottochiave del CATID dell'Extender appropriato incluso nella chiave del Registro di sistema HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\VisualStudio\8.0\Extenders durante l'installazione del componente aggiuntivo.
In modo dinamico, chiamando questo metodo in un metodo OnConnection del componente aggiuntivo.

Nota

I provider Extender registrati dinamicamente devono annullare la propria registrazione eseguendo la chiamata a UnregisterExtenderProvider al momento della chiusura. Questa operazione non viene eseguita nei provider registrati in modo statico.

Sicurezza di .NET Framework

Attendibilità totale per il chiamante immediato. Impossibile utilizzare questo membro in codice parzialmente attendibile. Per ulteriori informazioni, vedere Utilizzo di librerie da codice parzialmente attendibile.