Está disponível uma actualização que expande o mecanismo para apresentar tópicos de ajuda do snap-in de contexto para a MMC no Windows Server 2008

INTRODUÇÃO

Uma actualização que expande o mecanismo para apresentar os tópicos de ajuda de contexto do snap-in está disponível para o Microsoft Management Console (MMC) no Windows Server 2008. Esta actualização permite que os tópicos de ajuda do snap-ins de visualização de formas personalizadas em vez de numa janela de ajuda da MMC padrão. Por exemplo, esta actualização permite que um snap-in abrir um tópico de ajuda na Web em vez de um tópico de ajuda HTML (CHM) compilados.

Depois de aplica esta actualização, os programadores podem programar a MMC para enviar eventos de ajuda para o snap-in em vez de abrir um tópico da ajuda CHM. Por conseguinte, quando os utilizadores, clique no menu de ajuda ou prima F1, um evento é enviado para o snap-in para apresentar.

Mais informações

Comportamento de pré-actualização

A secção descreve o comportamento de evento ajuda antes da actualização for aplicada. O snap-in define o caminho de HelpTopic e a MMC coloca em cache estas informações. Quando a MMC apresenta um tópico de ajuda de contexto, a MMC abre uma janela de ajuda da MMC padrão sem chamar o snap-in. Se o snap-in tenha definido o tópico de ajuda para o item seleccionado, a janela de ajuda da MMC apresenta esse tópico. Não se for definido nenhum tópico de ajuda, a janela de ajuda da MMC mostra o tópico de ajuda da MMC 3.0 predefinido.

Um snap-in pode definir a propriedade HelpTopic nas seguintes três localizações:

  • ScopeNode classe

  • A classe EiconCards

  • A propriedade SelectionData que é utilizada pela classe vista

Comportamento de actualização posterior

Depois da actualização for aplicada, os programadores têm dois mecanismos para apresentar um tópico de ajuda, incluindo o que existe antes da actualização for aplicada.

Chamada de retorno

Um snap-in define a propriedade UseCustomHelp da classe SnapInSettingsAttribute para VERDADEIRO e, em seguida, o snap-in regista uma snap-in nível chamada de retorno. A chamada de retorno é accionada por MMC quando o snap-in pede que MMC apresenta um tópico de ajuda. Quando a propriedade UseCustomHelp estiver definida como True, o mecanismo de pré-lançamento de actualização é ignorado. A MMC não apresenta a janela de ajuda da MMC padrão.

Propriedade HelpTopic

Este mecanismo é aquele que existia antes da actualização foi aplicada. Este mecanismo funciona apenas se o snap-in não definir a propriedade UseCustomHelp para verdadeiro.

Para visualizar o tópico de ajuda de uma forma personalizada, a MMC tem siga estes passos:

  1. -Tem de definir a propriedade UseCustomHelp da classe SnapInSettingsAttribute como True.

  2. -Tem de registar uma chamada de retorno com a MMC.

Quando a MMC recebe um pedido para apresentar um tópico de ajuda, a MMC verifica primeiro as informações de snap-in de registo para ver se o snap-in definiu a propriedade UseCustomHelp . Se o snap-in não tiver definido a propriedade UseCustomHelp como True, a MMC inicia uma janela de ajuda da MMC padrão. Se o snap-in tiver definido a propriedade UseCustomHelp para True, a MMC não inicia uma janela de ajuda da MMC padrão. Em vez disso, a MMC localiza e acciona a chamada de retorno que se encontra registada pelo snap-in. Neste caso, o snap-in é totalmente responsável por apresentar o tópico de ajuda. Se o snap-in pretender utilizar o mecanismo de chamada de retorno para mostrar uma janela de ajuda da MMC padrão, pode chamar a função de SnapInBase.ShowHelpTopic .

Novo API expostas a snap-ins

UseCustomHelp é uma nova propriedade que é adicionada à classe de SnapInSettingsAttribute . Por predefinição, esta propriedade é definida como False. Para personalizar a apresentação de ajuda da MMC, um snap-in deve definir esta propriedade como True.

Microsoft.ManagementConsole.SnapInCallbackService é uma nova classe que permite a um snap-in registar uma snap-in nível chamada de retorno. A chamada de retorno processará a apresentação do tópico de ajuda.

SnapInHelpTopicCallback é um tipo de delegado ao qual um snap-in deve criar e registar com a MMC. Este delegado é um objecto como um parâmetro para especificar o item no qual o tópico de ajuda é pedida. Este parâmetro pode ser um dos seguintes tipos de objectos que têm a propriedade HelpTopic :

  • ScopeNode

  • SelectionData

  • EiconCards

Este parâmetro também pode ser nulo. Um parâmetro nulo indica que a MMC não consegue localizar um objecto.

RegisterSnapInHelpTopicHandler é uma função que um snap-in chama para registar uma chamada de retorno. Esta função assume dois parâmetros seguintes:

  • Instância do snap-in

  • Função de chamada de retorno

Nenhum dos parâmetros pode ser nulo. Caso contrário, a MMC lança uma excepção de ArgumentNullException.

Informações sobre a atualização

Os seguintes ficheiros estão disponíveis para transferência a partir do Centro de Transferências da Microsoft:

Actualização para Windows Server 2008 x64 Edition
Download

Actualização para Windows Server 2008 para sistemas baseados em Itanium
Download

Actualização para Windows Server 2008
Download

Actualização para Windows Vista
Download

Actualização para Windows Vista para sistemas baseados em x64
Download

Para mais informações sobre como transferir ficheiros de suporte da Microsoft, clique no número de artigo seguinte para visualizar o artigo na Base de Dados de Conhecimento Microsoft:

como obter ficheiros de suporte da Microsoft a partir de serviços online
A Microsoft analisou este ficheiro quanto à presença de virus. A Microsoft utilizou o software de deteção de vírus mais atual, que estava disponível na data em que o ficheiro foi publicado. O ficheiro está armazenado em servidores com segurança melhorada que ajudam a impedir alterações não autorizadas ao ficheiro.


Existe uma correção suportada pela Microsoft. No entanto, esta correção destina-se apenas a corrigir o problema descrito neste artigo. Aplique esta correcção apenas em sistemas que tenham este problema específico. Esta correcção poderá ser submetida a testes adicionais. Por conseguinte, se não estiver a ser gravemente afetado por este problema, recomendamos que aguarde pela próxima atualização de software que contenha esta correção.

Se a correcção estiver disponível para transferência, existirá uma secção de "Transferência de correcção disponível" na parte superior deste artigo da Base de dados de conhecimento. Se esta secção não for apresentada, contacte o Suporte ao Cliente da Microsoft para obter a correção.

Nota Caso ocorram problemas adicionais ou se for necessária a resolução de problemas, poderá ter de criar um pedido de assistência separado. Os custos de normais do suporte serão aplicados a questões de suporte adicional e problemas incluídos nesta correção específica. Para uma lista completa dos números de telefone de suporte e serviço de cliente da Microsoft ou para criar um pedido de assistência separado, visite o seguinte Web site da Microsoft:

Nota O formulário "Transferência de correcção disponível" apresenta os idiomas nos quais a correcção está disponível. Se não visualizar o seu idioma, é porque uma correcção não está disponível para esse idioma.

Pré-requisitos

Não existem pré-requisitos.

Requisito de reinício

Não é necessário reiniciar o computador depois de aplicar esta atualização.

Atualizar informações de substituição

Esta actualização não substitui quaisquer outras actualizações.

Informações de ficheiro

A versão inglesa desta actualização tem os atributos de ficheiro (ou atributos de ficheiro posteriores) listados na seguinte tabela. As datas e horas destes ficheiros são listadas na hora Universal Coordenada (UTC). Quando visualiza as informações do ficheiro, é convertido para a hora local. Para determinar a diferença entre a UTC e a hora local, utilize o separador Fuso horário no item data e hora no painel de controlo.

Windows Server 2008, edições de 32 bits

Precisa de mais ajuda?

Aumente os seus conhecimentos
Explore as formações
Seja o primeiro a obter novas funcionalidades
Aderir ao Microsoft insiders

As informações foram úteis?

Obrigado pelos seus comentários!

Obrigado pelo seu feedback! Parece que poderá ser benéfico reencaminhá-lo para um dos nossos agentes de suporte do Office.

×