This topic has not yet been rated - Rate this topic

ObjectExtenders.RegisterExtenderProviderUnk Method

Registers an Extender Provider for an IUnknown-based Extender category.

Namespace:  EnvDTE
Assembly:  EnvDTE (in EnvDTE.dll)
int RegisterExtenderProviderUnk(
	string ExtenderCATID,
	string ExtenderName,
	IExtenderProviderUnk ExtenderProvider,
	string LocalizedName
)

Parameters

ExtenderCATID
Type: System.String

Required. The Extender CATID.

ExtenderName
Type: System.String

Required. The Extender name. This is the programmatic name for the Extender and is used in the call to GetExtender.

ExtenderProvider
Type: EnvDTE.IExtenderProviderUnk

Required. The Extender Provider which implements the IExtenderProviderUnk interface.

LocalizedName
Type: System.String

Optional. The localized display name for the Extender.

Return Value

Type: System.Int32
An integer-valued cookiethat identifies the registration. This cookie must be passed back during UnregisterExtenderProvider.

RegisterExtenderProviderUnk is used by an IUnknown-based Extender Provider to dynamically register itself with the ObjectExtenders object under a particular CATID and name. An Extender Provider can register more than one Extender under one or more CATIDs.

There are two ways to register Extender Providers:

  • Statically, under the appropriate Extender CATID subkey in the registry key, HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\VisualStudio\8.0\Extenders, during the installation of your add-in.

  • Dynamically, by calling this method in an add-in's OnConnection method.

    NoteNote

    Dynamically-registered Extender Providers must unregister themselves by calling UnregisterExtenderProvider during shutdown. Statically-registered providers should not do so.

Did you find this helpful?
(1500 characters remaining)
© 2013 Microsoft. All rights reserved.