Método IComponent2::RestoreResultView (mmc.h)

Artigo
03/05/2024

O método RestoreResultView restaura a exibição de resultado. Esse método permite que um snap-in restaure detalhes específicos do snap-in de uma exibição de resultados. Para obter mais informações, consulte Restaurando exibições de resultado.

Esse método substitui o uso da notificação de MMCN_RESTORE_VIEW .

Sintaxe

HRESULT RestoreResultView(
  [in] MMC_COOKIE             cookie,
  [in] PRESULT_VIEW_TYPE_INFO pResultViewType
);

Parâmetros

[in] cookie

Um valor que especifica o identificador exclusivo cuja exibição de resultado será restaurada.

[in] pResultViewType

Um ponteiro para a estrutura RESULT_VIEW_TYPE_INFO para a exibição de resultado.

Retornar valor

Se tiver êxito, o valor retornado será S_OK. O snap-in pode retornar S_FALSE para impedir que o MMC restaure a exibição com base nas informações em *pResultViewType. Outros valores retornados indicam um código de erro.

Comentários

O membro pstrPersistableViewDescription de *pResultViewType especifica o nome atribuído à exibição de resultado. Para restaurar a exibição de resultado identificada pelo membro pstrPersistableViewDescription , o snap-in preenche os membros restantes de *pResultViewType. O nome da exibição de resultado é originalmente atribuído durante a implementação do snap-in de IComponent2::GetResultViewType2. O MMC chama IComponent2::RestoreResultView para que o snap-in possa restaurar as configurações de exibição internas quando a exibição de resultado for revisitada pelo usuário.

Quando o usuário personaliza a exibição, algumas das configurações (como opções de exibição ou modo de exibição) são conhecidas pelo MMC e algumas (como a mais antiga primeira no snap-in Visualizador de Eventos) são internas para o snap-in. Antes do MMC 2.0, não havia mecanismo para que o MMC se comunicasse com o snap-in para restaurar as configurações de exibição internas. Os métodos IComponent2::GetResultViewType2 e IComponent2::RestoreResultView no MMC 2.0, no entanto, fornecem o mecanismo pelo qual as configurações de exibição internas são restauradas. O snap-in persiste as configurações de exibição internas em relação ao membro pstrPersistableViewDescription da estrutura RESULT_VIEW_TYPE_INFO . Quando o MMC chama IComponent2::RestoreResultView para restaurar a exibição de resultado, o snap-in usa as configurações persistentes para concluir a restauração da exibição.

O usuário revisita o modo de exibição de resultado pressionando os botões MMC Back/Forward ou carregando um arquivo de console salvo.