ObjectExtenders.RegisterExtenderProviderUnk (Método)

Artículo
08/10/2011

Registra un proveedor extensor para una categoría Extender basada en IUnknown.

Espacio de nombres: EnvDTE
Ensamblado: EnvDTE (en EnvDTE.dll)

Sintaxis

'Declaración
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

Parámetros

ExtenderCATID
Tipo: System.String
Obligatorio.CATID del objeto Extender.

ExtenderName
Tipo: System.String
Obligatorio.Nombre del objeto Extender.Se trata del nombre del objeto Extender asignado mediante programación y se utiliza en la llamada a GetExtender.

ExtenderProvider
Tipo: EnvDTE.IExtenderProviderUnk
Obligatorio.El proveedor extensor que implementa la interfaz IExtenderProviderUnk.

LocalizedName
Tipo: System.String
Opcional.Traducción (localización) del nombre para mostrar del objeto Extender.

Valor devuelto

Tipo: System.Int32
Una cookiecon valor entero que identifica el registro.Esta cookie se debe devolver durante la ejecución del método UnregisterExtenderProvider.

Comentarios

Un proveedor extensor basado en IUnknown utiliza RegisterExtenderProviderUnk para registrarse dinámicamente con el objeto ObjectExtenders bajo un Id. de categoría y un nombre específicos. Un proveedor extensor puede registrar más de un objeto Extender bajo uno o más Id. de categoría.

Hay dos formas de registrar proveedores extensores:

Estáticamente, en la subclave apropiada de Id. de categoría del extensor en la clave de Registro HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\VisualStudio\8.0\Extenders, durante la instalación del complemento.
Dinámicamente, llamando a este método en el método OnConnection de un complemento.

Nota

Los proveedores extensores de registro dinámico deben anular su registro llamando al método UnregisterExtenderProvider al cerrar. Los proveedores extensores de registro estático no deben hacerlo.

Seguridad de .NET Framework

Plena confianza para el llamador inmediato. Un código de confianza parcial no puede utilizar este miembro. Para obtener más información, vea Utilizar bibliotecas de código que no es de plena confianza.