IExtenderProviderUnk.GetExtender-Methode

Artikel
05/16/2015

Gibt einen Extender für das jeweilige Objekt unter der angegebenen Kategorie zurück.

Namespace: EnvDTE
Assembly: EnvDTE (in EnvDTE.dll)

Syntax

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

Parameter

ExtenderCATID
Typ: String

Die CATID des angeforderten Extenders.

ExtenderName
Typ: String

Der Name des angeforderten Extenders.

ExtendeeObject
Typ: Object

Das Extendee-Objekt.

ExtenderSite
Typ: EnvDTE.IExtenderSite

Die Extenderwebsite, die durch eine IExtenderSite-Schnittstelle dargestellt wird.

Cookie
Typ: Int32

Ein Cookie zur Identifizierung des Extenders.

Rückgabewert

Typ: Object
Ein Extender.

Hinweise

GetExtender gibt den Extender für die jeweilige CATID und den Namen der angegebenen Extendee-Instanz zurück. Diese Methode wird nur aufgerufen, wenn CanExtend den Wert true zurückgibt.

Der Extenderanbieter muss ExtenderSite-Objekt und Cookie speichern.

Warnung

Der Extender-Manager verwaltet einen internen Cache von Extenderobjekten und muss benachrichtigt werden, wenn sie zerstört werden.Sie müssen sofort nach dem Zerstören von Extenderobjekten NotifyDelete aufrufen.Sie dürfen nicht warten, bis sich die Anwendung im Leerlauf befindet, da möglicherweise andere Visual Studio-Komponenten versuchen, auf das zerstörte Extenderobjekt zuzugreifen, bevor Sie die Methode aufrufen.Wenn dies geschieht, stürzt Visual Studio möglicherweise ab.

Hinweis

Das Extendee-Objekt wird als IUnknown-Schnittstelle übergeben.

.NET Framework-Sicherheit

Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter Verwenden von Bibliotheken aus teilweise vertrauenswürdigem Code.