IComponent::GetResultViewType-Methode (mmc.h)

Die IComponent::GetResultViewType-Methode bestimmt, wie die Ergebnisbereichsansicht aussehen soll.

Syntax

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

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.

[out] ppViewType

Ein Zeiger auf die Adresse einer Zeichenfolge, die die Ansicht angibt, die für das angegebene Cookie angezeigt werden soll. Der Aufgerufene (Snap-In) ordnet die Ansichtstypzeichenfolge mithilfe der COM-API-Funktion CoTaskMemAlloc zu, und der Aufrufer (MMC) gibt sie mithilfe von CoTaskMemFree frei.

Die zurückgegebene Zeichenfolge hängt vom Ansichtstyp ab:

Standardliste

Für Standardlistenansichten verwendet MMC diesen Wert nicht. Wenn das Snap-In nur Standardlistenansichten verwendet, kann das Snap-In ppViewType auf NULL festlegen. MMC verwendet Standardmäßige Listenansichten als Standardansichtstyp.

Aufgabenblock

Für eine Taskpadansicht, die MMC-Taskpadvorlagen verwendet, sollte ppViewType auf die Adresse einer Zeichenfolge verweisen, die den Ressourcenpfad zur Taskpadvorlage und einen Gruppennamen enthält, der das Taskpad identifiziert. Beachten Sie, dass MMC den Gruppennamen in Aufrufen von IExtendTaskPad-Methoden übergibt, damit das Snap-In das angezeigte Taskpad identifizieren kann (dies ist wichtig, wenn das Snap-In über mehrere Taskpads verfügt).

Die Zeichenfolge sollte die folgende Form aufweisen:

"res:// filepath/template#groupname"

Dabei ist filepath der vollständige Pfad zur ausführbaren MMC-Datei (MMC.exe), vorlage der Dateiname der Vorlage, die als Ressource in der durch filepath angegebenen Datei gespeichert ist, und groupname der Name, der das Taskpad identifiziert.

MMC stellt die folgenden HTML-Dateien als Vorlagen bereit:

Die folgende Zeichenfolge gibt beispielsweise an, dass MMC.exe den Pfad c:\Windows\System32\mmc.exe hat, das Standardtaskpad angezeigt wird (default.htm) und der Gruppenname tpad1: "res://c:\Windows\System32\mmc.exe/default.htm#tpad1".

Bei einer Taskpadansicht, die eine benutzerdefinierte HTML-Seite verwendet, sollte ppViewType auf die Adresse einer Zeichenfolge verweisen, die den Ressourcenpfad zur HTML-Datei des benutzerdefinierten Taskpads und einen Gruppennamen enthält, der das Taskpad identifiziert. Die Zeichenfolge hat das gleiche Format wie die Zeichenfolge für eine MMC-Taskpadvorlage– mit der Ausnahme, dass der Dateipfad den Pfad zur DLL des Snap-Ins angeben sollte, in der die benutzerdefinierte HTML-Seite als Ressource gespeichert wird.

Benutzerdefinierte OCX

Für eine benutzerdefinierte Ansicht, die von einem benutzerdefinierten OLE-Steuerelement (OCX) bereitgestellt wird, sollte ppViewType auf die Adresse einer Zeichenfolge verweisen, die die Zeichenfolgendarstellung der CLSID des benutzerdefinierten Steuerelements enthält. Die Zeichenfolge muss mit einer offenen geschweiften Klammer ({) beginnen und mit einer engen geschweiften Klammer (}) enden. Die folgende Zeichenfolge stellt das Calendar-Steuerelement dar und kann im ppViewType-Parameter zurückgegeben werden, um das Calendar-Steuerelement im Ergebnisbereich anzuzeigen: "{8E27C92B-1264-101C-8A2F-040224009C02}".

MMC ermöglicht eine einzelne instance jedes OCX-Typs pro Snap-In-instance pro Ansicht. Wenn die Option MMC_VIEW_OPTIONS_CREATENEW nicht ausgewählt ist, zeigt MMC die zwischengespeicherten OCX-instance für alle Bereichselemente des Snap-Ins an, die diese OCX-Ansicht anfordern. Wenn die Option MMC_VIEW_OPTIONS_CREATENEW ausgewählt ist, zerstört MMC das zwischengespeicherte OCX und erstellt jedes Mal, wenn ein Element die OCX-Ansicht anfordert.

Benutzerdefinierte Webseite

Für eine benutzerdefinierte Ansicht, die von einer Webseite bereitgestellt wird, sollte ppViewType auf die Adresse einer Zeichenfolge verweisen, die die URL für die Seite enthält. Die folgende Zeichenfolge stellt die URL für die Microsoft-Website dar und kann im ppViewType-Parameter zurückgegeben werden, um die Website im Ergebnisbereich anzuzeigen: "www.microsoft.com".

[out] pViewOptions

Ein Zeiger auf den Wert, der der Konsole Optionen bereitstellt, die vom besitzenden Snap-In angegeben werden. Dieser Wert kann eine Kombination aus folgendem Wert sein:

MMC_VIEW_OPTIONS_CREATENEW (0x0010)

Für eine benutzerdefinierte OCX-Ansicht. In MMC 1.2 wird die OCX immer zwischengespeichert. Wenn dieses Flag nicht angegeben ist, zeigt MMC 1.2 die zwischengespeicherten OCX-instance für alle Bereichselemente des Snap-Ins an, die diese OCX-Ansicht anfordern. Wenn dieses Flag angegeben ist, zerstört MMC 1.2 das zwischengespeicherte OCX und erstellt jedes Mal, wenn ein Element die OCX-Ansicht anfordert, ein neues element. In MMC 2.0 wird das OCX nur zwischengespeichert, wenn dieses Flag nicht festgelegt ist. In MMC 2.0 kann das Snap-In alle OCX-Elemente freigeben, wenn der Knoten deaktiviert wird, wenn dieses Flag festgelegt ist.

Nachdem das Snap-In seine OCX-Zwischenspeicherungsoption für einen Knoten angegeben hat (entweder mit oder ohne das flag MMC_VIEW_OPTIONS_CREATENEW), darf es die Optionsauswahl für diese instance des Snap-Ins nicht ändern.

MMC_VIEW_OPTIONS_EXCLUDE_SCOPE_ITEMS_FROM_LIST (0x00000040)

Neu in MMC 1.2. In einer Standardlistenansicht weist diese Option MMC an, Bereichselemente in der Ansicht auszublenden. Bereichselemente werden in virtuellen Listenansichten automatisch ausgeblendet.

MMC_VIEW_OPTIONS_FILTERED (0x0008)

Benachrichtigt MMC, dass das Snap-In gefilterte Ansichten unterstützt. Weitere Informationen finden Sie unter Hinzufügen von gefilterten Ansichten.

MMC_VIEW_OPTIONS_LEXICAL_SORT (0x00000080)

Neu in MMC 1.2. In einer Standardlistenansicht weist diese Option MMC an, zuerst alle Bereichselemente (einschließlich Erweiterungen) lexikalisch zu sortieren, gefolgt von allen Ergebniselementen. Die Schnittstellen IResultDataCompare und IResultDataCompareEx werden ignoriert, wenn diese Option festgelegt ist.

MMC_VIEW_OPTIONS_MULTISELECT (0x0004)

Ermöglicht mehrere Elementauswahlen in der Ergebnisbereichsansicht.

MMC_VIEW_OPTIONS_NOLISTVIEWS (0x0001)

Weist die Konsole an, die Standardauswahl der Listenansicht im Menü Ansicht nicht anzuzeigen. Ermöglicht dem Snap-In, nur eigene benutzerdefinierte Ansichten im Ergebnisbereich anzuzeigen.

MMC_VIEW_OPTIONS_NONE (0)

Keine Ansichtsoptionen ausgewählt. Dies ist die Standardansichtsoption.

MMC_VIEW_OPTIONS_OWNERDATALIST (0x0002)

Ein -Wert, der angibt, dass die Listenansicht des Ergebnisbereichs eine virtuelle Liste sein soll.

MMC_VIEW_OPTIONS_USEFONTLINKING (0x0020)

Verwenden Sie die Schriftartverknüpfung für Ergebniselemente (für mehrsprachige Unterstützung). Einzelheiten finden Sie in den Hinweisen.

Wenn ppViewType ein benutzerdefinierter Ansichtstyp ist, werden die Ansichtsoptionen, die sich auf die Standardlistenansichten auswirken, von MMC angewendet, wenn die Ansicht von einer benutzerdefinierten Ansicht zu einer Standardlistenansicht gewechselt wird.

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

Hinweise

Der Aufgerufene (Snap-In) ordnet die Ansichtstypzeichenfolge mithilfe der COM-API-Funktion CoTaskMemAlloc zu, und der Aufrufer (MMC) gibt sie mithilfe von CoTaskMemFree frei.

MMC ruft GetResultViewType auf, wenn ein Snap-In-Bereichselement ausgewählt ist. Wenn Sie von einer Standardlistenansicht zu einer benutzerdefinierten Ansicht wechseln, muss das Snap-In IConsole2::SelectScopeItem aufrufen, um das Element erneut auszuwählen und zu erzwingen, dass MMC GetResultViewType erneut aufruft . Dadurch kann das Snap-In die entsprechende benutzerdefinierte OCX- oder Webseite angeben, damit SIE von MMC geladen werden kann. Wenn Sie von einer benutzerdefinierten Ansicht zu einer Standardlistenansicht wechseln, ruft MMC automatisch GetResultViewType auf und legt den entsprechenden Listenansichtstyp fest.

Bei einer Unicode-Zeichenfolge bestimmt die Schriftartverknüpfungsfunktion die beste Schriftart, die diese Zeichenfolge anzeigt. Wenn Sie beispielsweise eine Listenansicht mit Servernamen auffüllen und wussten, dass die Hälfte auf Japanisch und die Hälfte auf Russisch erfolgen würde, würden Sie die Optionen für die Schriftartverknüpfungsansicht festlegen, und MMC würde eine geeignete Schriftart bestimmen. Standardmäßig wird keine Schriftartverknüpfung verwendet, da die Leistung bei der Suche nach der entsprechenden Schriftart durch MMC gering ist.

Ein Cookie ist ein Zeiger auf eine Struktur, die informationen enthält, die für ein bestimmtes Element eindeutig sind. Es wird über das lParam-Element einer SCOPEDATAITEM-Struktur übergeben.

Anforderungen

Weitere Informationen

IComponent

Idataobject