Uma atualização que estende o mecanismo para exibir tópicos de Ajuda de contexto snap-in está disponível para o MMC no Windows Server 2008

Uma atualização que estende o mecanismo para exibir tópicos de Ajuda de contexto snap-in está disponível para Microsoft Management Console (MMC) no Windows Server 2008. Esta atualização permite que o snap-ins exibir tópicos da Ajuda de formas personalizadas em vez de em uma janela de Ajuda do MMC padrão. Por exemplo, esta atualização permite que um snap-in que abrir um tópico da Ajuda em vez de um tópico da Ajuda compilado CHM (HTML).

Depois que essa atualização for aplicada, os desenvolvedores podem programar o MMC para enviar eventos de Ajuda para o snap-in em vez de abrir um tópico da Ajuda do CHM. Portanto, quando os usuários clicarem no menu Ajuda ou pressione F1, um evento é enviado para o snap-in para exibir.

Comportamento Pre-Update

A seção descreve o comportamento do evento ajuda antes a atualização for aplicada. O snap-in define o caminho HelpTopic e o MMC armazena em cache essas informações. Quando o MMC exibe um tópico da Ajuda contexto, o MMC abre uma janela de Ajuda do MMC padrão sem chamar o snap-in. Se o snap-in definiu o tópico da Ajuda para o item selecionado, a janela Ajuda do MMC mostra esse tópico. Não se for definido nenhum tópico da Ajuda, a janela Ajuda do MMC mostra o tópico da Ajuda do MMC 3.0 padrão.

Um snap-in pode definir a propriedade HelpTopic nos seguintes três locais:

• A classe de ScopeNode
• A classe PropertyPage
• A propriedade SelectionDate que é usada pela classe Exibir

Comportamento Post-Update

Depois que a atualização for aplicada, os desenvolvedores têm dois mecanismos para exibir um tópico da Ajuda incluindo a que existe antes da atualização for aplicada.

Retorno de chamada

Um snap-in define a propriedade UseCustomHelp da classe SnapInSettingsAttribute como True e, em seguida, o snap-in registra um snap-in de retorno de nível chamada. O retorno de chamada é disparado pelo MMC quando o snap-in solicita que o MMC exibir um tópico da Ajuda. Quando a propriedade UseCustomHelp é definida como True, o mecanismo pre-update é ignorado. O MMC não exibe a janela Ajuda do MMC padrão.

Propriedade HelpTopic

Esse mecanismo é aquele que existia antes da atualização foi aplicada. Esse mecanismo funciona somente se o snap-in não defina a UseCustomHelp propriedade como True.

Para exibir o tópico da Ajuda de uma maneira personalizada, o MMC deve seguir essas etapas:

1. Ele deve defina a propriedade UseCustomHelp da classe SnapInSettingsAttribute como True.
2. Ele deve registrar um retorno de chamada com o MMC.

Quando o MMC recebe uma solicitação para exibir um tópico da Ajuda, o MMC primeiro verifica as informações de registro snap-in para verificar se o snap-in possui definir a propriedade UseCustomHelp . Se o snap-in não tiver definido a propriedade UseCustomHelp como True, o MMC iniciar uma janela de Ajuda do MMC padrão. Se o snap-in tiver definido a propriedade UseCustomHelp como True, o MMC não inicia uma janela de Ajuda do MMC padrão. Em vez disso, o MMC localiza e aciona o retorno de chamada que está registrado pelo snap-in. Nesse caso, o snap-in é completamente responsável por exibir o tópico da Ajuda. Se o snap-in quiser usar o mecanismo de retorno de chamada para mostrar uma janela de Ajuda do MMC padrão, ele pode chamar a função SnapInBase.ShowHelpTopic .

Novas APIs que estão expostas a snap-ins

UseCustomHelp é uma nova propriedade que é adicionada à classe SnapInSettingsAttribute . Por padrão, essa propriedade é definida como False. Para personalizar a exibição de Ajuda do MMC, um snap-in deve definir essa propriedade como True.

Microsoft.ManagementConsole.SnapInCallbackService é uma nova classe que permite que um snap-in registrar um snap-in de retorno de nível chamada. O retorno de chamada irá lidar com a exibição do tópico da Ajuda.

SnapInHelpTopicCallback é um tipo de delegado que um snap-in deve criar e registrar com o MMC. Esse delegado utiliza um objeto como um parâmetro para especificar o item no qual o tópico da Ajuda é solicitada. Este parâmetro pode ser um dos seguintes tipos de objetos que têm a propriedade HelpTopic :

• ScopeNode
• SelectionDate
• PropertyPage

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

RegisterSnapInHelpTopicHandler é uma função que um snap-in chama para registrar um retorno de chamada. Essa função usa dois parâmetros a seguintes:

• Instância do snap-in
• Função de retorno de chamada

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

Atualizar informações

Os seguintes arquivos estão disponíveis para download no Centro de download da Microsoft:

atualização para Windows Server 2008 x 64 Edition
Download the KB951725 package now. (http://www.microsoft.com/downloads/details.aspx?FamilyId=1A267131-0362-468C-AB62-28E8EB4ECAAD)

atualização para o Windows Server 2008 para sistemas baseados no Itanium
Download the KB951725 package now. (http://www.microsoft.com/downloads/details.aspx?FamilyId=2EC05D52-E648-4C5F-A362-1EF74B887400)

atualização para o Windows Server 2008
Download the KB951725 package now. (http://www.microsoft.com/downloads/details.aspx?FamilyId=E5633FDA-CCE2-4B52-81BD-60469336CE58)

actualização para o Windows Vista
Download the KB951725 package now. (http://www.microsoft.com/downloads/details.aspx?FamilyId=6D6FDC3A-18B3-4F30-9CC4-1805E2B83CB4)

atualização para o Windows Vista para sistemas com base em 64 x
Download the KB951725 package now. (http://www.microsoft.com/downloads/details.aspx?FamilyId=3ADC541E-F3F8-4A55-AF21-A3DE5219072C)

Para obter mais informações sobre como baixar os arquivos de suporte da Microsoft, clique no número abaixo para ler o artigo na Base de dados de Conhecimento da Microsoft: Microsoft examinou esse arquivo em busca de vírus. Microsoft utilizou o mais recente software de detecção de vírus que estava disponível na data em que o arquivo foi publicado. O arquivo é armazenado em servidores com segurança avançada que ajudam a evitar qualquer alteração não autorizada no arquivo.

Um hotfix suportado está disponível no Microsoft. No entanto, esse hotfix destina-se a corrigir o problema descrito neste artigo. Aplique-o somente aos sistemas que apresentarem esse problema específico. Esta correcção poderá submetida a testes adicionais. Portanto, se você não tiver sido gravemente afetado por esse problema, recomendamos que você aguarde a próxima atualização de software que contém esse hotfix.

Se o hotfix está disponível para download, há uma seção "Download de Hotfix disponível" na parte superior neste artigo da Base de dados de Conhecimento. Se esta seção não for exibida, contate o atendimento e suporte para obter o hotfix.

Observação Se ocorrerem problemas adicionais ou se qualquer solução de problemas é necessária, talvez você precise criar uma solicitação de serviço separada. Os custos normais de suporte serão aplicados a questões de suporte adicionais e problemas que não se qualificam para esse hotfix específico. Para obter uma lista completa de números de telefone de suporte e Atendimento Microsoft ou para criar uma solicitação de serviço separada, visite o seguinte site: Observação O formulário "Download de Hotfix disponível" exibe os idiomas para os quais o hotfix está disponível. Se você não vir seu idioma, é porque um hotfix não está disponível para esse idioma.

Pré-requisitos

Não pré-requisitos são necessários.

Requisitos de reinicialização

Não é necessário reiniciar o computador após aplicar essa atualização.

Atualizar informações de substituição

Esta atualização não substitui outras atualizações.

Informações sobre o arquivo

A versão em inglês dessa atualização apresenta atributos de arquivo (ou atributos de arquivo posteriores) listados na tabela a seguir. As datas e horas desses arquivos estão listadas no horário de universal coordenado (UTC). Quando você exibe as informações do arquivo, ele é convertido para a hora local. Para encontrar a diferença entre o UTC e a hora local, use a guia fuso horário no item Data e hora no painel de controle.

Windows Server 2008, edições de 32 bits

Windows Server 2008, edições baseadas no Itanium com suporte

Windows Server 2008, edições de 64 bits

Tópico da Ajuda de contexto

Um tópico de Ajuda de contexto é um tipo de tópico da Ajuda que está associado a um item snap-in, como um nó de escopo. Para iniciar tópicos da Ajuda de contexto, os usuários poderão pressionar F1, ou eles podem clique em Ajuda no menu ações , em um menu de atalho ou no painel de ações.

Para obter mais informações sobre terminologia de atualização de software, clique no número abaixo para ler o artigo na Base de dados de Conhecimento da Microsoft: