INTRODUÇÃO
Uma atualização que estende o mecanismo para exibir tópicos da Ajuda do snap-in de contexto está disponível para o Microsoft Management Console (MMC) no Windows Server 2008. Esta atualização permite que a exibição de snap-ins de tópicos da Ajuda formas personalizadas, em vez de em uma janela de Ajuda do MMC padrão. Por exemplo, esta actualização permite um snap-in abrir um tópico da Ajuda da Web em vez de um tópico da Ajuda HTML (CHM) compilados.
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.
Mais informações
Comportamento de pré-atualização
A seção descreve o comportamento de eventos de ajuda antes da atualização é aplicada. O snap-in define o caminho HelpTopic e o MMC armazena essas informações. Quando o MMC exibe um tópico da Ajuda de 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 de Ajuda do MMC mostra esse tópico. Se nenhum tópico da Ajuda for definido, a janela de Ajuda do MMC mostra o tópico da Ajuda do MMC 3.0 padrão.
Um snap-in pode definir a propriedade HelpTopic em três locais a seguir:
-
A classe ScopeNode
-
A classe PropertyPage
-
A propriedade SelectionDate que é usada pelo modo de exibição de classe
Comportamento de pós-atualização
Depois que a atualização for aplicada, os desenvolvedores têm dois mecanismos para exibir um tópico de Ajuda, inclusive o que existe antes da atualização é aplicada.
Retorno de chamada
Um snap-in define a propriedade UseCustomHelp da classe SnapInSettingsAttribute como True e o snap-in registra um snap-in do nível de retorno de chamada. O retorno de chamada é disparado pelo MMC quando solicita o snap-in MMC exibir um tópico da Ajuda. Quando a propriedade UseCustomHelp estiver definida como True, o mecanismo de atualização de pré-lançamento é ignorado. O MMC não exibe a janela de Ajuda do MMC padrão.
Propriedade HelpTopic
Esse mecanismo é aquele que existia antes que a atualização foi aplicada. Esse mecanismo funciona somente se o snap-in não define a propriedade UseCustomHelp como True.
Para exibir o tópico da Ajuda no modo personalizado, o MMC deve seguir estas etapas:
-
Ele deve definir a propriedade UseCustomHelp da classe SnapInSettingsAttribute como True.
-
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 do snap-in para ver se o snap-in tiver definido a propriedade UseCustomHelp . Se o snap-in não definiu a propriedade UseCustomHelp como True, o MMC é iniciado em uma janela de Ajuda do MMC padrão. Se o snap-in tiver definido a propriedade UseCustomHelp como True, o MMC não inicie uma janela de Ajuda do MMC padrão. Em vez disso, o MMC localiza e aciona o retorno de chamada que é registrado pelo snap-in. Nesse caso, o snap-in é completamente responsável por exibir o tópico da Ajuda. Se o snap-in deseja 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 são expostos aos snap-ins
UseCustomHelp é uma nova propriedade é 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 registre um snap-in do nível de retorno de chamada. O retorno de chamada irá lidar com a exibição do tópico da Ajuda.
SnapInHelpTopicCallback é um tipo de representante que um snap-in deve criar e registrar com o MMC. Esse delegado pega 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 possuem a propriedade HelpTopic :
-
ScopeNode
-
SelectionDate
-
PropertyPage
Esse parâmetro também pode ser Null. Um parâmetro Null indica que o MMC não consegue encontrar um objeto.
RegisterSnapInHelpTopicHandler é uma função que um snap-in chama registrar um retorno de chamada. Essa função usa dois parâmetros a seguir:
-
Instância do snap-in
-
Função de retorno de chamada
Nenhum dos parâmetros pode ser Null. Caso contrário, o MMC lança uma exceção ArgumentNullException.
Informações sobre a atualização
Os seguintes arquivos estão disponíveis para download no Centro de Download da Microsoft:
Atualização para o Windows Server 2008 x64 Edition
Atualização para o Windows Server 2008 para sistemas baseados no Itanium
Atualização para o Windows Server 2008
Atualização para o Windows Vista
Atualização para o Windows Vista para sistemas baseados em x64
Para obter mais informações sobre como baixar arquivos de suporte da Microsoft, clique no número abaixo para ler o artigo na Base de Dados de Conhecimento da Microsoft:
119591 como obter arquivos de suporte da Microsoft a partir de serviços online
A Microsoft examinou esse arquivo em busca de vírus. A Microsoft usou o software de detecção de vírus mais recente que estava disponível na data em que o arquivo foi publicado. O arquivo está armazenado em servidores com segurança avançada que ajudam a evitar qualquer alteração não autorizada no arquivo.
Um hotfix compatível foi disponibilizado pela Microsoft. No entanto, esse hotfix destina-se a corrigir somente o problema descrito neste artigo. Aplique este hotfix somente aos sistemas que apresentarem esse problema específico. Esta correção poderá ser submetida a testes adicionais. Portanto, se esse problema não o prejudicar, recomendamos que você aguarde a próxima atualização de software que contenha esse hotfix.
Se o hotfix estiver disponível para download, há uma seção "Download de Hotfix disponível" na parte superior deste artigo da Base de Conhecimento. Se essa seção não for exibida, entre em contato com o suporte e atendimento ao cliente Microsoft para obter o hotfix.
Observação: caso outros problemas estejam ocorrendo ou caso qualquer solução de problemas seja 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 sejam específicos deste hotfix. Para obter uma lista completa dos números de telefone do Atendimento Microsoft e suporte ou para criar uma solicitação de serviço separada, visite o seguinte site da Microsoft:
http://support.microsoft.com/contactus/?ws=supportObservação: o formulário "Baixar Hotfix disponível" exibe os idiomas para os quais o hotfix está disponível. Caso você não veja seu idioma, é porque um hotfix não está disponível para esse idioma.
Pré-requisitos:
Não existem pré-requisitos.
Requisitos de reinicialização:
Você não precisa reiniciar o computador após aplicar essa atualização.
Informações de substituição da atualização
Esta atualização não substitui outras atualizações.
Informações sobre o arquivo:
A versão em inglês desta atualização tem os atributos de arquivo (ou atributos de arquivo posteriores) listados na tabela a seguir. As datas e horas desses arquivos estão listadas na Hora Universal Coordenada (UTC). Quando você exibe as informações do arquivo, ele é convertido para a hora local. Para localizar 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
|
Nome do Arquivo |
Versão do arquivo |
Tamanho do arquivo |
Data |
Hora |
Plataforma |
|---|---|---|---|---|---|
|
Microsoft.managementconsole.dll |
6.0.6001.22169 |
188,416 |
30-Apr-2008 |
05:31 |
x86 |
|
Mmcex.dll |
6.0.6001.22169 |
417,792 |
30-Apr-2008 |
05:31 |
x86 |
|
Mmcfxcommon.dll |
6.0.6001.22169 |
110,592 |
30-Apr-2008 |
05:31 |
x86 |
Windows Server 2008, edições com base em Itanium
|
Nome do Arquivo |
Versão do arquivo |
Tamanho do arquivo |
Data |
Hora |
Plataforma |
|---|---|---|---|---|---|
|
Microsoft.managementconsole.dll |
6.0.6001.22169 |
188,416 |
30-Apr-2008 |
05:31 |
x86 |
|
Mmcfxcommon.dll |
6.0.6001.22169 |
110,592 |
30-Apr-2008 |
05:31 |
x86 |
Windows Server 2008, edições de 64 bits
|
Nome do Arquivo |
Versão do arquivo |
Tamanho do arquivo |
Data |
Hora |
Plataforma |
|---|---|---|---|---|---|
|
Microsoft.managementconsole.dll |
6.0.6001.22169 |
188,416 |
30-Apr-2008 |
05:31 |
x86 |
|
Mmcfxcommon.dll |
6.0.6001.22169 |
110,592 |
30-Apr-2008 |
05:31 |
x86 |
Mais informações
Tópico da Ajuda de contexto
Um tópico da Ajuda de contexto é um tipo de tópico da Ajuda associado um item snap-in, como um nó de escopo. Para iniciar os tópicos de ajuda de contexto, os usuários poderão pressionar F1 ou eles podem clicar em Ajuda no menu ações , em um menu de atalho ou no painel de ações.
Para obter mais informações sobre a terminologia de atualização de software, clique no número abaixo para ler o artigo na Base de Conhecimento da Microsoft:
824684 descrição da terminologia padrão usada para descrever as atualizações de software
