Entradas del Registro de complementos de nivel de aplicación

Actualización: noviembre 2007

Cuando implemente complementos creados con Visual Studio Tools para Office, debe crear un conjunto específico de entradas del Registro. Estas entradas del Registro proporcionan información que permite a la aplicación de Microsoft Office detectar y cargar el complemento. Para obtener más información, vea Arquitectura de los complementos de nivel de aplicación.

Al generar un proyecto, Visual Studio Tools para Office crea estas entradas del Registro en el equipo de desarrollo para poder depurar con facilidad el complemento. Para obtener más información, consulte Información general acerca del proceso de compilación de soluciones de Office.

Para obtener información acerca de cómo se crean las claves del Registro en equipos de usuario final cuando se implementa el complemento, vea Implementar soluciones de Office (2007 System) y Implementar complementos de nivel de aplicación (2003 System).

En este tema, el texto identificador del complemento representa un identificador exclusivo para el complemento. De forma predeterminada, el identificador es el nombre del proyecto de complemento.

Entradas del Registro en Microsoft Office System 2007

Las entradas del Registro de complementos necesarias en Microsoft Office System 2007 se encuentran bajo la siguiente clave del Registro en todas las aplicaciones excepto en Microsoft Office Visio:

HKEY_CURRENT_USER\Software\Microsoft\Office\nombre de la aplicación\Complementos\identificador del complemento

En Visio, las entradas del Registro se encuentran en la clave del Registro siguiente:

HKEY_CURRENT_USER\Software\Microsoft\Visio\Complementos\identificador del complemento

Nota:
Las aplicaciones de Microsoft Office System 2007 sólo reconocen los complementos de Visual Studio Tools para Office que están registrados en HKEY_CURRENT_USER. Esto significa que no puede implementar un complemento de Visual Studio Tools para Office en Microsoft Office System 2007 para todos los usuarios de un equipo registrando el complemento bajo HKEY_LOCAL_MACHINE.

En la tabla siguiente se muestran las entradas que deben incluirse bajo esta clave del Registro.

Entry	Type	Value
Description	REG_SZ	Breve descripción del complemento. Esta descripción se muestra cuando el usuario selecciona el complemento en el panel Complementos del cuadro de diálogo Opciones en la aplicación de Microsoft Office.
FriendlyName	REG_SZ	Un nombre descriptivo del complemento que se muestra en el cuadro de diálogo Complementos COM de la aplicación de Microsoft Office. El valor predeterminado es el identificador del complemento.
LoadBehavior	REG_DWORD	Un valor que especifica cuándo la aplicación intenta cargar el complemento y el estado actual del complemento (cargado o no cargado). De forma predeterminada, este valor se establece en 3, lo que especifica que el complemento se carga al inicio. Para obtener más información, vea Valores de LoadBehavior.
Manifest	REG_SZ	La ruta de acceso completa del manifiesto de implementación del complemento. La ruta de acceso puede ser una ubicación del equipo local, un recurso compartido de red (UNC) o un servidor web (HTTP). Nota: Cuando se genera un complemento en el equipo de desarrollo, Visual Studio Tools para Office anexa la cadena | vstolocal (es decir, el carácter de canalización | seguido de vstolocal) a esta entrada del Registro. Esto ayuda a Visual Studio Tools para Office a cargar el complemento cuando se ejecuta desde Visual Studio en el equipo de desarrollo.

Entradas del Registro para las áreas de formulario de Outlook

Si crea un área de formulario personalizada en un complemento para Microsoft Office Outlook 2007, se utiliza una entrada del Registro para registrar el área de formulario en Outlook. Esta entrada del Registro se encuentra bajo la clave siguiente:

HKEY_CURRENT_USER\Software\Microsoft\Office\Outlook\FormRegions\clase de mensaje

Para obtener más información, vea Specifying Form Regions in the Windows Registry. Para obtener más información sobre las áreas de formulario de Outlook, vea Crear áreas de formulario de Outlook.

Entradas del Registro en Microsoft Office 2003

Las entradas del Registro de complementos necesarias en Microsoft Office 2003 se encuentran bajo las claves del Registro siguientes:

• HKEY_CURRENT_USER\Software\Microsoft\Office\nombre de la aplicación\Complementos\identificador del complemento

• HKEY_CURRENT_USER\Software\Classes\identificador del complemento\CLSID

• HKEY_CURRENT_USER\Software\Classes\CLSID\{CLSID del complemento}

• HKEY_CURRENT_USER\Software\Classes\CLSID\{CLSID del complemento}\InprocServer32

• HKEY_CURRENT_USER\Software\Classes\CLSID\{CLSID del complemento}\ProgID

• HKEY_CURRENT_USER\Software\Classes\CLSID\{CLSID del complemento}\Programmable

• HKEY_CURRENT_USER\Software\Classes\CLSID\{CLSID del complemento}\VersionIndependentProgID

Nota:
Puede hacer que un complemento de Visual Studio Tools para Office para Microsoft Office 2003 esté a disposición de todos los usuarios de un equipo; para ello, cree las claves del Registro en HKEY_LOCAL_MACHINE en lugar de en HKEY_CURRENT_USER.

En las secciones siguientes se detallan las entradas que deben incluirse en cada clave del Registro. El texto <CLSID del complemento> representa el identificador de clase único global (CLSID) del complemento. Para obtener el CLSID del complemento, puede consultar una de las ubicaciones siguientes:

• El valor predeterminado de la entrada del Registro HKEY_CURRENT_USER\Software\Classes\identificador del complemento\CLSID que se creó en el equipo de desarrollo al generar el complemento.

• El elemento ProjectGuid de los archivos de proyecto .csproj (en C#) o .vbproj (en Visual Basic).

Nota:
Algunas de las entradas del Registro que aparecen en la lista siguiente deberá crearlas en un subárbol diferente si está implementando un complemento de Microsoft Office 2003 en Windows Vista. Para obtener más información, vea Entradas del Registro de complementos de Microsoft Office 2003 en Windows Vista.

HKEY_CURRENT_USER\Software\Microsoft\Office\<nombre de la aplicación>\Complementos\<identificador del complemento>

Nota:
En los complementos de Visio, utilice la clave siguiente: HKEY_CURRENT_USER\Software\Microsoft\Visio\Complementos\identificador del complemento

HKEY_CURRENT_USER\Software\Classes\identificador del complemento

HKEY_CURRENT_USER\Software\Classes\identificador del complemento\CLSID

HKEY_CURRENT_USER\Software\Classes\CLSID\{<CLSID del complemento>}

HKEY_CURRENT_USER\Software\Classes\CLSID\{<CLSID del complemento>}\InprocServer32

Entry	Type	Value
(Default)	REG_SZ O bien, REG_EXPAND_SZ	La ruta de acceso completa del cargador de Visual Studio Tools para Office del equipo que está ejecutando el complemento. Esta entrada se debe establecer siempre en %CommonProgramFiles%\Microsoft Shared\VSTO\8.0\AddinLoader.dll. Para obtener más información sobre el cargador de Visual Studio Tools para Office, vea Información general sobre el motor en tiempo de ejecución de Microsoft Visual Studio Tools para Office. Nota: Si utiliza una variable de entorno en la ruta de acceso, utilice el tipo REG_EXPAND_SZ para esta entrada. De lo contrario, utilice el tipo REG_SZ.
ManifestLocation	REG_SZ	La ruta de acceso del manifiesto de aplicación para el complemento. Debe ser una carpeta local del equipo cliente.
ManifestName	REG_SZ	El nombre del manifiesto de aplicación para el complemento.
ThreadingModel	REG_SZ	Modelo de subprocesamiento. Esta entrada debe establecerse en Both.

HKEY_CURRENT_USER\Software\Classes\CLSID\{<CLSID del complemento>}\ProgID

HKEY_CURRENT_USER\Software\Classes\CLSID\{<CLSID del complemento>}\Programmable

HKEY_CURRENT_USER\Software\Classes\CLSID\{<CLSID del complemento>}\VersionIndependentProgID

Entradas del Registro de complementos de Microsoft Office 2003 en Windows Vista

Si está implementando un complemento de Microsoft Office 2003 en un equipo en el que se ejecuta Windows Vista, debe crear algunas claves del Registro en otro subárbol del Registro en los siguientes casos:

• El usuario está ejecutando la aplicación de Microsoft Office 2003 con un token de acceso de administrador completo.

  O bien,

• El usuario ha desactivado el Control de cuentas de usuario (UAC).

En estos casos, debe crear las claves de registro COM (es decir, todas las claves definidas en HKEY_CURRENT_USER\Software\Classes) en HKEY_LOCAL_MACHINE\Software\Classes.

Debe utilizar el subárbol Machine, porque, en estos casos, Windows Vista sólo busca las claves de registro COM en HKEY_LOCAL_MACHINE. Para obtener información acerca de cómo se modifican las claves del Registro en el proyecto de instalación predeterminado, vea Proyectos de instalación para complementos de nivel de aplicación (2003 System).

Nota:
No mueva las claves del Registro que hay en HKEY_CURRENT_USER\Software\Microsoft en estos escenarios.

Valores de LoadBehavior

La entrada de LoadBehavior que se encuentra bajo la clave HKEY_CURRENT_USER\Software\Microsoft\Office\nombre de la aplicación\Complementos\identificador del complemento contiene un valor que especifica cuándo la aplicación intenta cargar el complemento y el estado actual del complemento (cargado o no cargado). De forma predeterminada, esta entrada se establece en 3 al generar o implementar el complemento.

En la tabla siguiente se enumeran los valores posibles de la entrada LoadBehavior.

Vea también

Conceptos

Arquitectura de los complementos de nivel de aplicación

Información general acerca del proceso de compilación de soluciones de Office

Implementar soluciones de Office (2007 System)

Implementar complementos de nivel de aplicación (2003 System)

Otros recursos

Arquitectura de las soluciones de Visual Studio Tools para Office