Hay una actualización que extiende el mecanismo para mostrar temas de Ayuda de contexto del complemento de MMC en Windows Server 2008

Se aplica a: Windows Server 2008 StandardWindows Server 2008 EnterpriseWindows Server 2008 Datacenter

INTRODUCCIÓN


Hay una actualización que extiende el mecanismo para mostrar temas de Ayuda de contexto, complemento de Microsoft Management Console (MMC) en Windows Server 2008. Esta actualización permite complementos mostrar temas de Ayuda de formas personalizadas en lugar de en una ventana de Ayuda de MMC estándar. Por ejemplo, esta actualización permite un complemento abre un tema de Ayuda de Web en lugar de un tema de ayuda compilada (CHM) de HTML.

Después de aplica esta actualización, los desarrolladores pueden programar MMC para enviar eventos de ayuda para el complemento en lugar de abrir un tema de ayuda CHM. Por lo tanto, cuando los usuarios haga clic en el menú Ayuda o presionen F1, se envía un evento para el complemento de para mostrar.

Más información


Comportamiento de la actualización anterior

La sección describe el comportamiento del evento antes de aplica la actualización. El complemento define la ruta de acceso HelpTopic y MMC almacena en caché esta información. Cuando la MMC muestra un tema de Ayuda de contexto, MMC abre una ventana de Ayuda de MMC estándar sin llamar el complemento. Si el complemento ha definido el tema de ayuda para el elemento seleccionado, la ventana Ayuda de MMC muestra ese tema. Si no se ha definido ningún tema de ayuda, la ventana Ayuda de MMC muestra el tema de Ayuda de MMC 3.0 de forma predeterminada.

Un complemento puede establecer la propiedad HelpTopic en las tres ubicaciones siguientes:
  • La clase ScopeNode
  • La clase PropertyPage
  • La propiedad SelectionData que es utilizada por la clase de vista

Comportamiento posteriores a la actualización

Una vez aplicada la actualización, los desarrolladores tienen dos mecanismos para mostrar un tema de ayuda, incluido el que existe antes de aplica la actualización.

Devolución de llamada

Un complemento establece la propiedad UseCustomHelp de la clase SnapInSettingsAttribute en True y, a continuación, el complemento registra un complemento de nivel devolución de llamada. La devolución de llamada se activa mediante la consola MMC cuando el complemento solicita que MMC mostrar un tema de ayuda. Cuando se establece la propiedad UseCustomHelp en True, se omite el mecanismo de actualización anterior. MMC no muestra la ventana de Ayuda de MMC estándar.

Propiedad HelpTopic

Este mecanismo es el que existía antes de que se ha aplicado la actualización. Este mecanismo sólo funciona si el complemento no establece la propiedad UseCustomHelp en True.

Para mostrar el tema de Ayuda de una manera personalizada, MMC debe seguir estos pasos:
  1. Debe establecer la propiedad UseCustomHelp de la clase SnapInSettingsAttribute en True.
  2. Se debe registrar una devolución de llamada con MMC.
Cuando el complemento MMC recibe una solicitud para mostrar un tema de ayuda, MMC comprueba primero la información de registro del complemento para ver si el complemento ha establecido la propiedad UseCustomHelp . Si el complemento no estableció la propiedad UseCustomHelp en True, el complemento MMC inicia una ventana de Ayuda de MMC estándar. Si el complemento ha establecido la propiedad UseCustomHelp en True, el complemento MMC no inicia una ventana de Ayuda de MMC estándar. En su lugar, MMC busca y desencadena la devolución de llamada que se registra el complemento. En este caso, el complemento es completamente responsable de mostrar el tema de ayuda. Si el complemento quiere utilizar el mecanismo de devolución de llamada para mostrar una ventana de Ayuda de MMC estándar, puede llamar a la función SnapInBase.ShowHelpTopic .

API nuevas que se exponen a complementos

UseCustomHelp es una propiedad nueva que se agrega a la clase SnapInSettingsAttribute . De forma predeterminada, esta propiedad se establece en False. Para personalizar la pantalla de Ayuda de MMC, un complemento debe establecer esta propiedad en True.

Microsoft.ManagementConsole.SnapInCallbackService es una clase nueva que permite a un complemento de registrar un complemento de nivel devolución de llamada. La devolución de llamada que controlará la presentación de tema de ayuda.

SnapInHelpTopicCallback es un tipo de delegado que un complemento debe crear y registrar con MMC. Este delegado toma un objeto como un parámetro para especificar el elemento en el que se solicita el tema de ayuda. Este parámetro puede ser uno de los siguientes tipos de objetos que tienen la propiedad HelpTopic :
  • ScopeNode
  • SelectionData
  • PropertyPage
Este parámetro también puede ser Null. Un parámetro Null indica que MMC no puede encontrar un objeto.

RegisterSnapInHelpTopicHandler es una función que llama a un complemento para registrar una devolución de llamada. Esta función toma los dos parámetros siguientes:
  • Instancia de complemento
  • Función de devolución de llamada
Ninguno de los parámetros puede ser Null. De lo contrario, el complemento MMC inicia una excepción ArgumentNullException.

Información de actualización

Los archivos siguientes están disponibles para su descarga desde Centro de descarga de Microsoft:

Actualización para Windows Server 2008 x64 Edition
Download Descargue ahora el paquete KB951725.

Actualización para Windows Server 2008 para sistemas basados en Itanium
Download Descargue ahora el paquete KB951725.

Actualización para Windows Server 2008
Download Descargue ahora el paquete KB951725.

Actualización para Windows Vista
Download Descargue ahora el paquete KB951725.

Actualización para Windows Vista para sistemas basados en x64
Download Descargue ahora el paquete KB951725.

Para obtener más información acerca de cómo descargar archivos de soporte técnico de Microsoft, haga clic en el número de artículo siguiente para ver el artículo en Microsoft Knowledge Base:
119591 cómo obtener archivos de soporte técnico de Microsoft desde los servicios en línea
Microsoft analizó este archivo en busca de virus. Microsoft ha utilizado el software de detección de virus más reciente que estaba disponible en la fecha en que se publicó el archivo. El archivo se almacena en servidores seguros que ayudan a evitar cambios no autorizados en el archivo.


Existe un hotfix disponible desde Microsoft. Sin embargo, esta revisión se diseñó para corregir únicamente el problema que se describe en este artículo. Aplíquela sólo a sistemas que experimenten este problema específico. Esta revisión podría ser sometida a comprobaciones adicionales. Por lo tanto, si no se ve muy afectado por este problema, recomendamos que espere a la próxima actualización de software que contenga este hotfix.

Si la revisión está disponible para su descarga, hay una sección de "Descarga de revisión disponible" en la parte superior de este artículo de Knowledge Base. Si esta sección no aparece, póngase en contacto con el servicio al cliente de Microsoft y soporte técnico para obtener la revisión.

Nota: Si se producen problemas adicionales o si se requiere cualquier otra solución, será necesario crear una solicitud de revisión independiente. Los costos habituales de soporte se aplicarán a las preguntas de soporte técnico adicionales y problemas que no califican para esta revisión específica. Para obtener una lista completa de los números de teléfono de servicio al cliente de Microsoft o para crear una solicitud de servicio independiente, visite el siguiente sitio Web de Microsoft:Nota: El formulario de "Descarga de Hotfix disponible" muestra los idiomas para los que el Hotfix está disponible. Si no ve su idioma, es porque no hay una revisión para ese idioma.

Requisitos previos

No hay requisitos previos.

Requisito de reinicio

No tiene que reiniciar el equipo después de aplicar esta actualización.

Información para sustituir la actualización

Esta actualización no sustituye a otras actualizaciones.

Información de archivo

La versión en inglés de esta actualización tiene los atributos de archivo (o atributos de último archivo) mostrados en la tabla siguiente. Las fechas y horas de estos archivos se muestran en la hora Universal coordinada (UTC). Al ver la información del archivo, se convierte en hora local. Para encontrar la diferencia entre la hora UTC y la hora local, utilice la ficha Zona horaria en el elemento de Fecha y hora del Panel de control.
Windows Server 2008, ediciones de 32 bits
Nombre del archivoVersión del archivoTamaño de archivoFechaHoraPlataforma
Microsoft.managementconsole.dll6.0.6001.22169188,41630-Apr-200805:31x86
Mmcex.dll6.0.6001.22169417,79230-Apr-200805:31x86
Mmcfxcommon.dll6.0.6001.22169110.59230-Apr-200805:31x86
Windows Server 2008, ediciones basadas en Itanium
Nombre del archivoVersión del archivoTamaño de archivoFechaHoraPlataforma
Microsoft.managementconsole.dll6.0.6001.22169188,41630-Apr-200805:31x86
Mmcfxcommon.dll6.0.6001.22169110.59230-Apr-200805:31x86
Las ediciones de 64 bits de Windows Server 2008
Nombre del archivoVersión del archivoTamaño de archivoFechaHoraPlataforma
Microsoft.managementconsole.dll6.0.6001.22169188,41630-Apr-200805:31x86
Mmcfxcommon.dll6.0.6001.22169110.59230-Apr-200805:31x86

Más información


Tema de Ayuda de contexto

Un tema de Ayuda de contexto es un tipo de tema de ayuda que está asociado a un elemento de complemento, como un nodo de ámbito. Para iniciar los temas de Ayuda de contexto, los usuarios pueden presionar F1 o pueden hacer clic en Ayuda en el menú acciones , en un menú contextual o en el panel Acciones.

Para obtener más información acerca de la terminología de la actualización de software, haga clic en el número de artículo siguiente para verlo en Microsoft Knowledge Base:
824684 descripción de la terminología estándar que se utiliza para describir las actualizaciones de software de Microsoft