IComponent2::GetResultViewType2-Methode (mmc.h)

Die GetResultViewType2-Methode ruft den Ergebnisansichtstyp ab. Diese Methode ersetzt die IComponent::GetResultViewType-Methode .

Syntax

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

Parameter

[in] cookie

Ein Wert, der den von Snapin bereitgestellten eindeutigen Bezeichner für das Bereichselement angibt. Weitere Informationen zu Cookies in MMC finden Sie unter Cookies.

[in, out] pResultViewType

Ein Zeiger auf die RESULT_VIEW_TYPE_INFO Struktur für die Ergebnisansicht. Wenn Ihr Snap-In IComponent2 implementiert, muss das pstrPersistableViewDescription-Element der RESULT_VIEW_TYPE_INFO-Struktur eine gültige Ansichtsbeschreibungszeichenfolge enthalten. Andernfalls initialisiert MMC Ihr Snap-In nicht. Das pstrPersistableViewDescription-Element muss von CoTaskMemAlloc zugewiesen werden. Das Snap-In darf pstrPersistableViewDescription nicht freigeben, da es von MMC freigegeben wird.

Rückgabewert

Bei erfolgreicher Ausführung wird der Rückgabewert S_OK. Andere Rückgabewerte weisen auf einen Fehlercode hin.

Hinweise

Während der Erstellung der Ergebnisansicht ruft MMC die IComponent2::GetResultViewType2-Methode des Snap-Ins auf. Wenn der Benutzer die Ergebnisansicht mit dem pstrPersistableViewDescription-Member von *pResultViewType erneut aufruft, ruft MMC die IComponent2::RestoreResultView-Methode des Snap-Ins auf, zu der das Snap-In snap-in spezifische Details (falls vorhanden) für die wiederhergestellte Ergebnisansicht bereitstellen kann. Der Benutzer überprüft die Ergebnisansicht über die MMC-Schaltflächen "Zurück/Vorwärts " oder das Laden einer gespeicherten Konsolendatei. Weitere Informationen zur Verwendung der Methoden IComponent2::GetResultViewType2 und IComponent2::RestoreResultView finden Sie unter Wiederherstellen von Ergebnisansichten.

Wenn das Snap-In eine OCX-Ansicht (ActiveX-Steuerelement) implementiert, erstellt das Snap-In das OCX und stellt MMC den OCX IUnknown-Zeiger in der RESULT_VIEW_TYPE_INFO-Struktur bereit (insbesondere das pUnkControl-Element der Struktur). Das Snap-In hat die Kontrolle über die OCX-Erstellung, sodass das Snap-In Lizenzierungs- oder Sicherheitsprobleme nach Bedarf beheben kann. Während des Aufrufs von GetResultViewType2 kann das Snap-In auch das OCX initialisieren (das Snap-In erhält keine MMCN_INITOCX Benachrichtigung).

Anforderungen

Weitere Informationen

IComponent2::RestoreResultView

RESULT_VIEW_TYPE_INFO

Wiederherstellen von Ergebnisansichten