Metodo IComponent2::GetResultViewType2 (mmc.h)
Il metodo GetResultViewType2 recupera il tipo di visualizzazione dei risultati. Questo metodo sostituisce il metodo IComponent::GetResultViewType .
Sintassi
HRESULT GetResultViewType2(
[in] MMC_COOKIE cookie,
[in, out] PRESULT_VIEW_TYPE_INFO pResultViewType
);
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.
[in, out] pResultViewType
Puntatore alla struttura RESULT_VIEW_TYPE_INFO per la visualizzazione dei risultati. Se lo snap-in implementa IComponent2, il membro pstrPersistableViewDescription della struttura RESULT_VIEW_TYPE_INFO deve contenere una stringa di descrizione di visualizzazione valida; in caso contrario, MMC non inizializzerà lo snap-in. Il membro pstrPersistableViewDescription deve essere allocato da CoTaskMemAlloc. Lo snap-in non deve liberare pstrPersistableViewDescription, perché verrà liberato da MMC.
Valore restituito
In caso di esito positivo, il valore restituito viene S_OK. Altri valori restituiti indicano un codice di errore.
Commenti
Durante la creazione della visualizzazione dei risultati, MMC chiama il metodo IComponent2::GetResultViewType2 dello snap-in. Quando l'utente rivede la visualizzazione dei risultati denominata dal membro pstrPersistableViewDescription di *pResultViewType, MMC chiamerà il metodo IComponent2::RestoreResultView dello snap-in, in cui lo snap-in può fornire dettagli specifici dello snap-in (se presente) per la visualizzazione dei risultati ripristinata. L'utente rivede la visualizzazione dei risultati tramite i pulsanti MMC Indietro/Avanti o il caricamento di un file della console salvato. Per altre informazioni sull'uso dei metodi IComponent2::GetResultViewType2 e IComponent2::RestoreResultView , vedere Ripristino delle visualizzazioni dei risultati.
Se lo snap-in implementa una visualizzazione DISA (controllo ActiveX), lo snap-in crea l'oggetto OCX e fornisce MMC con il puntatore IUnknown OCX nella struttura RESULT_VIEW_TYPE_INFO (in particolare, il membro pUnkControl della struttura). Lo snap-in ha il controllo sulla creazione DELL'ESTENSIONE, quindi lo snap-in può risolvere i problemi di gestione delle licenze o della sicurezza in base alle esigenze. Durante la chiamata a GetResultViewType2, lo snap-in può anche inizializzare il file OCX (lo snap-in non riceverà una notifica di MMCN_INITOCX ).
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows Vista |
| Server minimo supportato | Windows Server 2008 |
| Piattaforma di destinazione | Windows |
| Intestazione | mmc.h |