Método IComponent::GetResultViewType (mmc.h)

O método IComponent::GetResultViewType determina qual deve ser a exibição do painel de resultados.

Sintaxe

HRESULT GetResultViewType(
  [in]  MMC_COOKIE cookie,
  [out] LPOLESTR   *ppViewType,
  [out] long       *pViewOptions
);

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.

[out] ppViewType

Um ponteiro para o endereço de uma cadeia de caracteres que especifica a exibição a ser exibida para o cookie especificado. O receptor chamado (snap-in) aloca a cadeia de caracteres de tipo de exibição usando a função de API COM CoTaskMemAlloc e o chamador (MMC) a libera usando CoTaskMemFree.

A cadeia de caracteres retornada depende do tipo de exibição:

Lista padrão

Para exibições de lista padrão, o MMC não usa esse valor. Se o snap-in usar apenas exibições de lista padrão, o snap-in poderá definir ppViewType como NULL. O MMC usa exibições de lista padrão como o tipo de exibição padrão.

Tarefas

Para uma exibição do bloco de tarefas que usa modelos de bloco de tarefas do MMC, ppViewType deve apontar para o endereço de uma cadeia de caracteres que contém o caminho do recurso para o modelo do bloco de tarefas e um nome de grupo que identifica o bloco de tarefas. Lembre-se de que o MMC passa o nome do grupo em chamadas para métodos IExtendTaskPad para habilitar o snap-in para identificar o bloco de tarefas específico que está sendo exibido (isso é importante se o snap-in tiver vários blocos de tarefas).

A cadeia de caracteres deve ter o seguinte formato:

"res:// filepath/template#groupname"

em que filepath é o caminho completo para o executável do MMC (MMC.exe), o modelo é o nome do arquivo do modelo armazenado como um recurso dentro do arquivo especificado por filepath e groupname é o nome que identifica o bloco de tarefas.

O MMC fornece os seguintes arquivos HTML como modelos:

Por exemplo, a cadeia de caracteres a seguir especifica que MMC.exe tem um caminho de c:\Windows\System32\mmc.exe, o bloco de tarefas padrão é exibido (default.htm) e o nome do grupo é tpad1: "res://c:\Windows\System32\mmc.exe/default.htm#tpad1".

Para uma exibição do bloco de tarefas que usa uma página HTML personalizada, ppViewType deve apontar para o endereço de uma cadeia de caracteres que contém o caminho do recurso para o arquivo HTML do bloco de tarefas personalizado e um nome de grupo que identifica o bloco de tarefas. A cadeia de caracteres tem o mesmo formato que a cadeia de caracteres de um modelo de bloco de tarefas do MMC, exceto que o caminho de arquivo deve especificar o caminho para a DLL do snap-in que armazena a página HTML personalizada como um recurso.

OCX personalizado

Para uma exibição personalizada fornecida por um OCX (controle personalizado OLE), ppViewType deve apontar para o endereço de uma cadeia de caracteres que contém a representação de cadeia de caracteres do CLSID do controle personalizado. A cadeia de caracteres deve começar com uma chave aberta ({) e terminar com uma chave fechada (}). A cadeia de caracteres a seguir representa o controle Calendar e pode ser retornada no parâmetro ppViewType para exibir o controle Calendário no painel de resultados: "{8E27C92B-1264-101C-8A2F-040224009C02}".

O MMC permite uma única instância de cada tipo OCX por instância de snap-in por exibição. Se a opção MMC_VIEW_OPTIONS_CREATENEW não estiver selecionada, o MMC exibirá a instância OCX armazenada em cache para qualquer um dos itens de escopo do snap-in que solicitam essa exibição OCX. Se a opção MMC_VIEW_OPTIONS_CREATENEW estiver selecionada, o MMC destruirá o OCX armazenado em cache e criará um novo sempre que um item solicitar a exibição OCX.

Página da Web personalizada

Para uma exibição personalizada fornecida por uma página da Web, ppViewType deve apontar para o endereço de uma cadeia de caracteres que contém a URL da página. A cadeia de caracteres a seguir representa a URL do site da Microsoft e pode ser retornada no parâmetro ppViewType para exibir o site no painel de resultados: "www.microsoft.com".

[out] pViewOptions

Um ponteiro para o valor que fornece ao console opções especificadas pelo snap-in proprietário. Esse valor pode ser uma combinação do seguinte:

MMC_VIEW_OPTIONS_CREATENEW (0x0010)

Para uma exibição OCX personalizada. No MMC 1.2, o OCX é sempre armazenado em cache. Se esse sinalizador não for especificado, o MMC 1.2 exibirá a instância OCX armazenada em cache para qualquer um dos itens de escopo do snap-in que solicitam essa exibição OCX. Se esse sinalizador for especificado, o MMC 1.2 destruirá o OCX armazenado em cache e criará (em seguida, armazenará em cache) um novo sempre que um item solicitar a exibição OCX. No MMC 2.0, o OCX será armazenado em cache somente se esse sinalizador não estiver definido. No MMC 2.0, o snap-in poderá liberar qualquer OCXs quando o nó for desmarcado se esse sinalizador estiver definido.

Depois que o snap-in tiver especificado sua opção de cache OCX para um nó (usando ou não o sinalizador MMC_VIEW_OPTIONS_CREATENEW ), ele não deverá alterar a opção de opção para esta instância do snap-in.

MMC_VIEW_OPTIONS_EXCLUDE_SCOPE_ITEMS_FROM_LIST (0x00000040)

Novidades no MMC 1.2. Em uma exibição de lista padrão, essa opção informa ao MMC para ocultar itens de escopo no modo de exibição. Os itens de escopo são ocultados automaticamente em exibições de lista virtual.

MMC_VIEW_OPTIONS_FILTERED (0x0008)

Notifica o MMC de que o snap-in dá suporte a exibições filtradas. Confira Adicionar exibições filtradas.

MMC_VIEW_OPTIONS_LEXICAL_SORT (0x00000080)

Novidades no MMC 1.2. Em uma exibição de lista padrão, essa opção instrui o MMC a classificar lexicalmente todos os itens de escopo (incluindo extensões) primeiro, seguido por todos os itens de resultado. As interfaces IResultDataCompare e IResultDataCompareEx são ignoradas quando essa opção é definida.

MMC_VIEW_OPTIONS_MULTISELECT (0x0004)

Permite várias seleções de itens no modo de exibição do painel de resultados.

MMC_VIEW_OPTIONS_NOLISTVIEWS (0x0001)

Instrui o console a se abster de apresentar opções de exibição de lista padrão no menu Exibir . Permite que o snap-in exiba apenas seus próprios modos de exibição personalizados no painel de resultados.

MMC_VIEW_OPTIONS_NONE (0)

Nenhuma opção de exibição selecionada. Essa é a opção de exibição padrão.

MMC_VIEW_OPTIONS_OWNERDATALIST (0x0002)

Um valor que especifica que a exibição de lista do painel de resultados deve ser uma lista virtual.

MMC_VIEW_OPTIONS_USEFONTLINKING (0x0020)

Use a vinculação de fonte em itens de resultado (para suporte multilíngue). Consulte Comentários para obter detalhes.

Se ppViewType for um tipo de exibição personalizado, as opções de exibição que afetam as exibições de lista padrão serão aplicadas pelo MMC quando a exibição for alternada de uma exibição personalizada para uma exibição de lista padrão.

Retornar valor

Esse método pode retornar um desses valores.

Comentários

O receptor chamado (snap-in) aloca a cadeia de caracteres de tipo de exibição usando a função de API COM CoTaskMemAlloc e o chamador (MMC) a libera usando CoTaskMemFree.

O MMC chama GetResultViewType quando um item de escopo de snap-in é selecionado. Ao alternar de um modo de exibição de lista padrão para um modo de exibição personalizado, o snap-in deve chamar IConsole2::SelectScopeItem para reselecionar o item e forçar o MMC a chamar GetResultViewType novamente. Isso permite que o snap-in especifique o OCX ou a página da Web personalizada apropriada para que o MMC possa carregá-lo. Ao alternar de uma exibição personalizada para uma exibição de lista padrão, o MMC chama automaticamente GetResultViewType e define o tipo de exibição de lista apropriado.

Dada uma cadeia de caracteres Unicode, o recurso de vinculação de fonte determina a melhor fonte para que exibe essa cadeia de caracteres. Por exemplo, se você estivesse preenchendo uma exibição de lista com nomes de servidor e soubesse que metade estaria em japonês e metade em russo, definiria as opções de exibição de vinculação de fonte e o MMC determinaria uma fonte apropriada. O padrão é não usar a vinculação de fonte, pois há um pequeno impacto no desempenho quando o MMC procura a fonte apropriada.

Um cookie é um ponteiro para uma estrutura que contém informações exclusivas para um item específico. Ele é passado por meio do membro lParam de uma estrutura SCOPEDATAITEM .

Requisitos

Confira também

Icomponent

Idataobject