IExtenderProviderUnk.GetExtender (Método)

Artículo
11/02/2012

Devuelve un objeto Extender para el objeto dado bajo la categoría especificada.

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

Sintaxis

'Declaración
Function GetExtender ( _
    ExtenderCATID As String, _
    ExtenderName As String, _
    ExtendeeObject As Object, _
    ExtenderSite As IExtenderSite, _
    Cookie As Integer _
) As Object

Object GetExtender(
    string ExtenderCATID,
    string ExtenderName,
    Object ExtendeeObject,
    IExtenderSite ExtenderSite,
    int Cookie
)

Object^ GetExtender(
    [InAttribute] String^ ExtenderCATID, 
    [InAttribute] String^ ExtenderName, 
    [InAttribute] Object^ ExtendeeObject, 
    [InAttribute] IExtenderSite^ ExtenderSite, 
    [InAttribute] int Cookie
)

abstract GetExtender : 
        ExtenderCATID:string * 
        ExtenderName:string * 
        ExtendeeObject:Object * 
        ExtenderSite:IExtenderSite * 
        Cookie:int -> Object

function GetExtender(
    ExtenderCATID : String, 
    ExtenderName : String, 
    ExtendeeObject : Object, 
    ExtenderSite : IExtenderSite, 
    Cookie : int
) : Object

Parámetros

ExtenderCATID
Tipo: System.String
CATID del objeto Extender que se solicita.

ExtenderName
Tipo: System.String
Nombre del objeto extender que se solicita.

ExtendeeObject
Tipo: System.Object
Objeto extendee.

ExtenderSite
Tipo: EnvDTE.IExtenderSite
Sitio del extensor, representado por una interfaz IExtenderSite.

Cookie
Tipo: System.Int32
Cookie que identifica al objeto Extender.

Valor devuelto

Tipo: System.Object
Un extensor.

Comentarios

GetExtender devuelve el objeto extender para el CATID y el nombre dados para la instancia extendee especificada.Sólo se llama a este método si CanExtend devuelve true.

El proveedor extensor debe conservar el objeto ExtenderSite y Cookie.

Precaución
El administrador de extensores mantiene una memoria caché interna de objetos Extender y debe recibir una notificación cuando se vayan a destruir.Debe llamar a NotifyDelete inmediatamente después de destruir los objetos Extender.No debe esperar a que la aplicación se vuelva inactiva, porque otros componentes de Visual Studio pueden intentar tener acceso al objeto Extender destruido antes de llamar al método.Si esto ocurre, Visual Studio puede bloquearse.

El administrador de extensores mantiene una memoria caché interna de objetos Extender y debe recibir una notificación cuando se vayan a destruir.Debe llamar a NotifyDelete inmediatamente después de destruir los objetos Extender.No debe esperar a que la aplicación se vuelva inactiva, porque otros componentes de Visual Studio pueden intentar tener acceso al objeto Extender destruido antes de llamar al método.Si esto ocurre, Visual Studio puede bloquearse.

[!NOTA]

El objeto extendee se pasa en forma de interfaz IUnknown.

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.