Metodo IComponent::GetResultViewType (mmc.h)

Il metodo IComponent::GetResultViewType determina quale dovrebbe essere la visualizzazione del riquadro dei risultati.

Sintassi

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

Parametri

[in] cookie

Valore che specifica l'identificatore univoco fornito dallo snapin per l'elemento dell'ambito. Per altre informazioni sui cookie in MMC, vedere Cookie.

[out] ppViewType

Puntatore all'indirizzo di una stringa che specifica la visualizzazione da visualizzare per il cookie specificato. Il chiamato (snap-in) alloca la stringa del tipo di visualizzazione usando la funzione API COM CoTaskMemAlloc e il chiamante (MMC) lo libera usando CoTaskMemFree.

La stringa restituita dipende dal tipo di visualizzazione:

Elenco standard

Per le visualizzazioni elenco standard, MMC non usa questo valore. Se lo snap-in usa solo visualizzazioni elenco standard, lo snap-in può impostare ppViewType su NULL. MMC usa le visualizzazioni elenco standard come tipo di visualizzazione predefinito.

Blocco attività

Per una visualizzazione taskpad che usa modelli di TaskPad MMC, ppViewType deve puntare all'indirizzo di una stringa che contiene il percorso della risorsa per il modello di TaskPad e un nome di gruppo che identifica il Blocco attività. Tenere presente che MMC passa il nome del gruppo nelle chiamate ai metodi IExtendTaskPad per consentire allo snap-in di identificare il blocco attività specifico visualizzato (questo è importante se lo snap-in ha più taskpad).

La stringa deve avere il formato seguente:

"res:// filepath/template#groupname"

dove filepath è il percorso completo dell'eseguibile MMC (MMC.exe), il modello è il nome file del modello archiviato come risorsa all'interno del file specificato dal percorso file e nomegruppo è il nome che identifica il Blocco attività.

MMC fornisce i file HTML seguenti come modelli:

Ad esempio, la stringa seguente specifica che MMC.exe ha un percorso di c:\Windows\System32\mmc.exe, viene visualizzato il blocco attività standard (default.htm) e il nome del gruppo è tpad1: "res://c:\Windows\System32\mmc.exe/default.htm#tpad1".

Per una visualizzazione taskpad che usa una pagina HTML personalizzata, ppViewType deve puntare all'indirizzo di una stringa che contiene il percorso della risorsa per il file HTML del TaskPad personalizzato e un nome di gruppo che identifica il Blocco attività. La stringa ha lo stesso formato della stringa per un modello di TaskPad MMC, ad eccezione del percorso file deve specificare il percorso della DLL dello snap-in che archivia la pagina HTML personalizzata come risorsa.

Custom OCX

Per una visualizzazione personalizzata fornita da un controllo personalizzato OLE (OCX), ppViewType deve puntare all'indirizzo di una stringa che contiene la rappresentazione di stringa del CLSID del controllo personalizzato. La stringa deve iniziare con una parentesi graffa aperta ({) e terminare con una parentesi graffa chiusa (}). La stringa seguente rappresenta il controllo Calendar e può essere restituita nel parametro ppViewType per visualizzare il controllo Calendar nel riquadro dei risultati: "{8E27C92B-1264-101C-8A2F-040224009C02}".

MMC consente una singola istanza di ogni tipo OCX per ogni istanza snap-in per visualizzazione. Se l'opzione MMC_VIEW_OPTIONS_CREATENEW non è selezionata, MMC visualizzerà l'istanza DI OCX memorizzata nella cache per uno degli elementi di ambito dello snap-in che richiedono questa visualizzazione OCX. Se l'opzione MMC_VIEW_OPTIONS_CREATENEW è selezionata, MMC eliminerà definitivamente il file OCX memorizzato nella cache e ne creerà uno nuovo ogni volta che un elemento richiede la visualizzazione OCX.

Pagina Web personalizzata

Per una visualizzazione personalizzata fornita da una pagina Web, ppViewType deve puntare all'indirizzo di una stringa contenente l'URL della pagina. La stringa seguente rappresenta l'URL del sito Web Microsoft e può essere restituita nel parametro ppViewType per visualizzare il sito Web nel riquadro dei risultati: "www.microsoft.com".

[out] pViewOptions

Puntatore al valore che fornisce alla console le opzioni specificate dallo snap-in proprietario. Questo valore può essere una combinazione dei seguenti elementi:

MMC_VIEW_OPTIONS_CREATENEW (0x0010)

Per una visualizzazione OCX personalizzata. In MMC 1.2 l'OCX viene sempre memorizzato nella cache. Se questo flag non viene specificato, MMC 1.2 visualizza l'istanza DI OCX memorizzata nella cache per uno degli elementi dell'ambito dello snap-in che richiedono questa visualizzazione OCX. Se questo flag viene specificato, MMC 1.2 elimina definitivamente il file OCX memorizzato nella cache e crea (quindi memorizza nella cache) un nuovo elemento ogni volta che un elemento richiede la visualizzazione OCX. In MMC 2.0, l'OCX verrà memorizzato nella cache solo se questo flag non è impostato. In MMC 2.0 lo snap-in può rilasciare qualsiasi OCX quando il nodo viene deselezionato se questo flag è impostato.

Dopo che lo snap-in ha specificato l'opzione di memorizzazione nella cache OCX per un nodo (utilizzando o meno il flag di MMC_VIEW_OPTIONS_CREATENEW ), non deve modificare la scelta dell'opzione per questa istanza dello snap-in.

MMC_VIEW_OPTIONS_EXCLUDE_SCOPE_ITEMS_FROM_LIST (0x00000040)

Novità di MMC 1.2. In una visualizzazione elenco standard questa opzione indica a MMC di nascondere gli elementi dell'ambito nella visualizzazione. Gli elementi di ambito vengono nascosti automaticamente nelle visualizzazioni elenco virtuali.

MMC_VIEW_OPTIONS_FILTERED (0x0008)

Notifica a MMC che lo snap-in supporta le visualizzazioni filtrate. Vedere Aggiunta di visualizzazioni filtrate.

MMC_VIEW_OPTIONS_LEXICAL_SORT (0x00000080)

Novità di MMC 1.2. In una visualizzazione elenco standard, questa opzione indica a MMC di ordinare in modo lessicale tutti gli elementi dell'ambito (incluse le estensioni), seguiti da tutti gli elementi dei risultati. Le interfacce IResultDataCompare e IResultDataCompareEx vengono ignorate quando questa opzione è impostata.

MMC_VIEW_OPTIONS_MULTISELECT (0x0004)

Consente la selezione di più elementi nella visualizzazione del riquadro dei risultati.

MMC_VIEW_OPTIONS_NOLISTVIEWS (0x0001)

Indica alla console di evitare di presentare opzioni standard per la visualizzazione elenco nel menu Visualizza . Consente allo snap-in di visualizzare solo le proprie visualizzazioni personalizzate nel riquadro dei risultati.

MMC_VIEW_OPTIONS_NONE (0)

Nessuna opzione di visualizzazione selezionata. Questa è l'opzione di visualizzazione predefinita.

MMC_VIEW_OPTIONS_OWNERDATALIST (0x0002)

Valore che specifica che la visualizzazione elenco del riquadro dei risultati deve essere un elenco virtuale.

MMC_VIEW_OPTIONS_USEFONTLINKING (0x0020)

Usa il collegamento dei tipi di carattere sugli elementi dei risultati (per il supporto multilingue). Per ulteriori informazioni, vedere Note.

Se ppViewType è un tipo di visualizzazione personalizzato, le opzioni di visualizzazione che influiscono sulle visualizzazioni elenco standard vengono applicate da MMC quando la visualizzazione passa da una visualizzazione personalizzata a una visualizzazione elenco standard.

Valore restituito

Questo metodo può restituire uno di questi valori.

Commenti

Il chiamato (snap-in) alloca la stringa del tipo di visualizzazione usando la funzione API COM CoTaskMemAlloc e il chiamante (MMC) lo libera usando CoTaskMemFree.

MMC chiama GetResultViewType quando è selezionato un elemento di ambito snap-in. Quando si passa da una visualizzazione elenco standard a una visualizzazione personalizzata, lo snap-in deve chiamare IConsole2::SelectScopeItem per selezionare di nuovo l'elemento e forzare MMC a chiamare nuovamente GetResultViewType . In questo modo, lo snap-in consente di specificare la pagina Web o IL FILE POPUP personalizzato appropriato in modo che MMC possa caricarlo. Quando si passa da una visualizzazione personalizzata a una visualizzazione elenco standard, MMC chiama automaticamente GetResultViewType e imposta il tipo di visualizzazione elenco appropriato.

Data una stringa Unicode, la funzionalità di collegamento del tipo di carattere determina il tipo di carattere migliore per la visualizzazione della stringa. Ad esempio, se si popola una visualizzazione elenco con nomi di server e si sapeva che metà sarebbe in giapponese e metà in russo, si imposterebbero le opzioni di collegamento del tipo di carattere e MMC determinerebbe un tipo di carattere appropriato. L'impostazione predefinita non prevede l'uso del collegamento dei tipi di carattere, perché si verifica un piccolo riscontro delle prestazioni quando MMC cerca il tipo di carattere appropriato.

Un cookie è un puntatore a una struttura che contiene informazioni univoce per un elemento specifico. Viene passato attraverso il membro lParam di una struttura SCOPEDATAITEM .

Requisiti

Vedi anche

IComponent

Idataobject