Metodo IComponent2::RestoreResultView (mmc.h)

Articolo
02/29/2024

Il metodo RestoreResultView ripristina la visualizzazione dei risultati. Questo metodo consente a uno snap-in di ripristinare i dettagli specifici dello snap-in di una visualizzazione dei risultati. Per altre informazioni, vedere Ripristino delle visualizzazioni dei risultati.

Questo metodo sostituisce l'uso della notifica di MMCN_RESTORE_VIEW .

Sintassi

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

Parametri

[in] cookie

Valore che specifica l'identificatore univoco la cui visualizzazione dei risultati verrà ripristinata.

[in] pResultViewType

Puntatore alla struttura RESULT_VIEW_TYPE_INFO per la visualizzazione dei risultati.

Valore restituito

Se ha esito positivo, il valore restituito è S_OK. Lo snap-in può restituire S_FALSE per impedire il ripristino della visualizzazione in base alle informazioni in *pResultViewType. Altri valori restituiti indicano un codice di errore.

Commenti

Il membro pstrPersistableViewDescription di *pResultViewType specifica il nome assegnato alla visualizzazione dei risultati. Per ripristinare la visualizzazione dei risultati identificata dal membro pstrPersistableViewDescription , lo snap-in compila i membri rimanenti di *pResultViewType. Il nome della visualizzazione dei risultati viene originariamente assegnato durante l'implementazione dello snap-in di IComponent2::GetResultViewType2. MMC chiama IComponent2::RestoreResultView in modo che lo snap-in possa ripristinare le impostazioni della visualizzazione interna quando la visualizzazione dei risultati viene rivisitata dall'utente.

Quando l'utente personalizza la visualizzazione, alcune delle impostazioni (ad esempio opzioni di visualizzazione o modalità di visualizzazione) sono note da MMC e alcune (ad esempio Oldest First in the Visualizzatore eventi snap-in) sono interne allo snap-in. Prima di MMC 2.0, non è stato presente alcun meccanismo per comunicare con MMC allo snap-in per ripristinare le impostazioni di visualizzazione interne. I Metodi IComponent2::GetResultViewType2 e IComponent2::RestoreResultView in MMC 2.0, tuttavia, forniscono il meccanismo in cui vengono ripristinate le impostazioni della visualizzazione interna. Lo snap-in mantiene le impostazioni di visualizzazione interne rispetto al membro pstrPersistableViewDescription della struttura RESULT_VIEW_TYPE_INFO . Quando MMC chiama IComponent2::RestoreResultView per ripristinare la visualizzazione dei risultati, lo snap-in usa le impostazioni persistenti per completare il ripristino della visualizzazione.

L'utente rivede la visualizzazione dei risultati premendo i pulsanti Indietro/Avanti MMC o caricando un file della console salvato.