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

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

Depois de aplicar esta actualização, os programadores podem programa da 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 Ajuda ou prima F1, um evento é enviado para o snap-in para apresentar.

Comportamento Pre-Update

A secção descreve comportamento de evento ajuda antes da actualização for aplicada. O snap-in define o caminho 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 definiu o tópico de ajuda para o item seleccionado, a janela de ajuda da MMC mostra 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 definido a propriedade HelpTopic nas seguintes três localizações:

• A ScopeNode classe
• A classe PropertyPage
• A propriedade SelectionData que é utilizada pela classe Ver

Comportamento POST-Update

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

Chamada de retorno

Um snap-in define a propriedade UseCustomHelp da classe SnapInSettingsAttribute como VERDADEIRO e, em seguida, o snap-in regista um retorno de nível snap-in. A chamada de retorno é accionada por MMC quando o snap-in de pedidos que MMC apresentar um tópico de ajuda. Quando a propriedade UseCustomHelp estiver definida como TRUE, o mecanismo pre-update é ignorado. A MMC não é apresentada 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 TRUE.

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

1. Deve definir a propriedade UseCustomHelp da classe SnapInSettingsAttribute como TRUE.
2. Com a MMC tem de registar uma chamada de retorno.

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 tiver definido 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 como TRUE, a MMC não inicia uma janela de ajuda da MMC padrão. Em vez disso, a MMC localiza e activa a chamada de retorno é registada pelo snap-in. Neste caso, o snap-in é completamente responsável para visualizar 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 SnapInBase.ShowHelpTopic .

Novo API expostos a snap-ins

UseCustomHelp é uma nova propriedade que adicionadas à classe SnapInSettingsAttribute . Por predefinição, esta propriedade é definida como FALSE. Para personalizar a ajuda da MMC, um snap-in deve definir esta propriedade como VERDADEIRO.

Microsoft.ManagementConsole.SnapInCallbackService é uma nova classe que permite a um snap-in registar um retorno de nível snap-in. A chamada de retorno processará a apresentação de 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 pedido o tópico de ajuda. Este parâmetro pode ser um dos seguintes tipos de objectos que têm a propriedade HelpTopic :

• ScopeNode
• SelectionData
• PropertyPage

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 chame a um snap-in para registar uma chamada de retorno. Esta função permite os seguintes dois parâmetros:

• 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 ArgumentNullException.

Actualizar informações

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

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

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

actualizaçã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)

actualização para o Windows Vista para sistemas baseados 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 transferir ficheiros de suporte da Microsoft, clique no número de artigo que se segue para visualizar o artigo na Microsoft Knowledge Base: Microsoft procedeu de vírus neste ficheiro. Microsoft utilizou o mais recente software de detecção de vírus que estava disponível na data em que o ficheiro foi publicado. O ficheiro é alojado em servidores com segurança avançada o que ajuda a impedir alterações não autorizadas ao ficheiro.

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

Se a correcção está disponível para transferência, existe uma secção "denominada 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 apresentado, contacte o serviço de cliente do Microsoft e suporte para obter a correcção.

Nota Se ocorram problemas adicionais ou se for necessária qualquer resolução de problemas, poderá ter de criar um pedido de assistência separado. Os custos normais do suporte serão aplicados a problemas adicionais e questões de suporte que não se enquadrem esta correcção específica. Para obter uma lista completa dos números de telefone do suporte de cliente do Microsoft ou para criar um pedido serviço separado, visite o seguinte Web site da Microsoft: Nota O formulário "Transferência de correcção disponível" apresenta os idiomas para a qual a correcção está disponível. Se não vir o idioma, é porque uma correcção não está disponível para esse idioma.

Pré-requisitos

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

Requisito de reinício

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

Actualizar informações de substituição

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

Informações do 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 indicadas 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

Windows Server 2008, edições baseadas em Itanium

Windows Server 2008, edições de 64 bits

Tópico de ajuda de contexto

Um tópico de ajuda de contexto é um tipo de tópico de ajuda associada a um snap-in de item, tal como um nó de âmbito. Para começar a tópicos de ajuda de contexto, os utilizadores podem premir F1 ou, em Ajuda no menu Acções , num menu de atalho ou no painel de acções.

Para obter mais informações sobre a terminologia de actualização de software, clique no número de artigo que se segue para visualizar o artigo na Microsoft Knowledge Base: