Método IComponent2::GetResultViewType2 (mmc.h)
O método GetResultViewType2 recupera o tipo de exibição de resultado. Esse método substitui o método IComponent::GetResultViewType .
Sintaxe
HRESULT GetResultViewType2(
[in] MMC_COOKIE cookie,
[in, out] PRESULT_VIEW_TYPE_INFO pResultViewType
);
Parâmetros
[in] cookie
Um valor que especifica o identificador exclusivo fornecido pelo snapin para o item de escopo. Para obter mais detalhes sobre cookies no MMC, consulte Cookies.
[in, out] pResultViewType
Um ponteiro para a estrutura RESULT_VIEW_TYPE_INFO para a exibição de resultado. Se o snap-in implementar IComponent2, o membro pstrPersistableViewDescription da estrutura RESULT_VIEW_TYPE_INFO deverá conter uma cadeia de caracteres de descrição de exibição válida; caso contrário, o MMC não inicializará o snap-in. O membro pstrPersistableViewDescription deve ser alocado por CoTaskMemAlloc. O snap-in não deve liberar pstrPersistableViewDescription, pois ele será liberado pelo MMC.
Retornar valor
Se tiver êxito, o valor retornado será S_OK. Outros valores retornados indicam um código de erro.
Comentários
Durante a criação da exibição de resultado, o MMC chama o método IComponent2::GetResultViewType2 do snap-in. Quando o usuário revisita a exibição de resultado nomeada pelo membro pstrPersistableViewDescription de *pResultViewType, o MMC chamará o método IComponent2::RestoreResultView do snap-in, momento em que o snap-in poderá fornecer detalhes específicos do snap-in (se houver) para o modo de exibição de resultado restaurado. O usuário revisita a exibição de resultados por meio dos botões Voltar/Avançar do MMC ou o carregamento de um arquivo de console salvo. Para obter mais informações sobre o uso dos métodos IComponent2::GetResultViewType2 e IComponent2::RestoreResultView , consulte Restaurando exibições de resultado.
Se o snap-in estiver implementando uma exibição OCX (controle ActiveX), o snap-in criará o OCX e fornecerá ao MMC o ponteiro OCX IUnknown na estrutura RESULT_VIEW_TYPE_INFO (especificamente, o membro pUnkControl da estrutura). O snap-in tem controle sobre a criação do OCX, para que o snap-in possa resolver problemas de licenciamento ou segurança conforme necessário. Durante a chamada para GetResultViewType2, o snap-in também pode inicializar o OCX (o snap-in não receberá uma notificação MMCN_INITOCX ).
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows Vista |
| Servidor mínimo com suporte | Windows Server 2008 |
| Plataforma de Destino | Windows |
| Cabeçalho | mmc.h |