IComponent：：GetResultViewType 方法 (mmc.h)

發行項
02/29/2024

IComponent：：GetResultViewType 方法會決定結果窗格檢視應該是什麼。

語法

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

參數

[in] cookie

值，指定範圍專案之嵌入式管理單元提供的唯一標識符。如需 MMC 中 Cookie 的詳細資訊，請參閱 Cookie。

[out] ppViewType

字串位址的指標，指定要顯示指定 Cookie 的檢視。被呼叫者 (嵌入式管理單元) 使用 COM API 函式 CoTaskMemAlloc 配置檢視類型字串，而呼叫端 (MMC) 使用 CoTaskMemFree 釋放它。

傳回的字串取決於檢視類型：

標準清單

針對標準清單檢視，MMC 不會使用此值。如果嵌入式管理單元只使用標準清單檢視，嵌入式管理單元可以將 ppViewType 設定為 NULL。 MMC 使用標準清單檢視作為預設檢視類型。

任務板

對於使用 MMC 任務板範本的工作板檢視， ppViewType 應該指向字串的位址，該字串包含任務板範本的資源路徑，以及識別任務板的組名。請注意，MMC 會傳遞呼叫 IExtendTaskPad 方法中的組名，讓嵌入式管理單元能夠識別要顯示的特定工作板， (如果嵌入式管理單元有多個任務板) ，這很重要。

字串格式應如下：

“res:// filepath/template#groupname”

其中 filepath 是 MMC 可執行檔的完整路徑 (MMC.exe) ， 範本是範本 的檔名，該範本會儲存為 filepath 所指定檔案內的資源， 而 groupname 是識別任務板的名稱。

MMC 提供下列 HTML 檔案作為範本：

資源檔	Description
default.htm	標準工作板的範本
listpad.htm	“vertical” 列表檢視任務板的範本
horizontal.htm	“horizontal” 列表檢視任務板的範本

例如，下列字串指定 MMC.exe 路徑為 c:\Windows\System32\mmc.exe、標準工作板會顯示 (default.htm) ，而組名為 tpad1：“res：//c:\Windows\System32\mmc.exe/default.htm#tpad1”。

對於使用自定義 HTML 頁面的工作板檢視， ppViewType 應該指向字串的位址，該字串包含自定義工作板 HTML 檔案的資源路徑，以及識別任務板的組名。字串的格式與 MMC 工作板範本的字串相同，但 filepath 應該指定嵌入式管理單元 DLL 的路徑，以將自定義 HTML 頁面儲存為資源。

自定義 OCX

若為 OLE 自定義控制項所提供的自訂檢視 (OCX ) ，ppViewType 應該指向包含自定義控件 CLSID 字串表示的字串位址。字串的開頭必須是左大括弧 ({) ，並以右大括號結尾 (}) 。下列字串代表 Calendar 控件，而且可以在 ppViewType 參數中傳回，以顯示結果窗格中的行事歷控件：「{8E27C92B-1264-101C-8A2F-040224009C02}」。

MMC 允許每個檢視的每個嵌入式管理單元實例的每個 OCX 類型單一實例。如果未選取 [MMC_VIEW_OPTIONS_CREATENEW ] 選項，MMC 將會針對任何要求此 OCX 檢視的嵌入式管理單元範圍項目顯示快取的 OCX 實例。如果選取 [MMC_VIEW_OPTIONS_CREATENEW ] 選項，MMC 將會終結快取的 OCX，並在每次專案要求 OCX 檢視時建立新的選項。

自訂網頁

針對網頁所提供的自定義檢視， ppViewType 應該指向包含頁面 URL 的字串位址。下列字串代表 Microsoft 網站的 URL，而且可以在 ppViewType 參數中傳回，以顯示結果窗格中的網站：「www.microsoft.com」。

[out] pViewOptions

值的指標，提供主控台的擁有嵌入式管理單元所指定的選項。此值可以是下列各項的組合：

MMC_VIEW_OPTIONS_CREATENEW (0x0010)

針對自定義 OCX 檢視。在 MMC 1.2 中，一律會快取 OCX。如果未指定此旗標，MMC 1.2 會顯示任何要求此 OCX 檢視之嵌入式管理單元範圍專案的快取 OCX 實例。如果指定此旗標，MMC 1.2 會終結快取的 OCX 並建立 (，然後在每次專案要求 OCX 檢視時快取) 新的旗標。在 MMC 2.0 中，只有在未設定此旗標時，才會快取 OCX。在 MMC 2.0 中，如果設定此旗標，嵌入式管理單元可以在取消選取節點時釋放任何 OCX。

一旦嵌入式管理單元使用或不使用 MMC_VIEW_OPTIONS_CREATENEW 旗標) 指定 (節點的 OCX 快取選項之後，它就不得變更此嵌入式管理單元實例的選項選項。

MMC_VIEW_OPTIONS_EXCLUDE_SCOPE_ITEMS_FROM_LIST (0x00000040)

MMC 1.2 的新功能。在標準清單檢視中，此選項會指示 MMC 隱藏檢視中的範圍專案。範圍專案會自動隱藏在虛擬清單檢視中。

MMC_VIEW_OPTIONS_FILTERED (0x0008)

通知 MMC 嵌入式管理單元支援篩選的檢視。請參閱新增篩選的檢視。

MMC_VIEW_OPTIONS_LEXICAL_SORT (0x00000080)

MMC 1.2 的新功能。在標準清單檢視中，此選項會指示 MMC 以語彙方式排序所有範圍專案， (包括延伸模組) ，後面接著所有結果專案。設定此選項時，會忽略 IResultDataCompare 和 IResultDataCompareEx 介面。

MMC_VIEW_OPTIONS_MULTISELECT (0x0004)

允許在結果窗格檢視中選取多個專案。

MMC_VIEW_OPTIONS_NOLISTVIEWS (0x0001)

告訴主控台不要在 [ 檢視 ] 功能表中呈現標準清單檢視選項。允許嵌入式管理單元只在結果窗格中顯示自己的自定義檢視。

MMC_VIEW_OPTIONS_NONE (0)

未選取檢視選項。這是預設檢視選項。

MMC_VIEW_OPTIONS_OWNERDATALIST (0x0002)

值，指定結果窗格清單檢視應該是虛擬清單。

MMC_VIEW_OPTIONS_USEFONTLINKING (0x0020)

針對多語系支援) ，使用結果專案 (的字型連結。如需詳細資訊，請參閱。

如果 ppViewType 是自定義檢視類型，當檢視從自定義檢視切換至標準清單檢視時，會影響標準清單檢視的檢視選項會由 MMC 套用。

傳回值

這個方法可以傳回其中一個值。

備註

被呼叫者 (嵌入式管理單元) 使用 COM API 函式 CoTaskMemAlloc 配置檢視類型字串，而呼叫端 (MMC) 使用 CoTaskMemFree 釋放它。

當選取嵌入式管理單元範圍專案時，MMC 會呼叫 GetResultViewType 。從標準清單檢視切換至自定義檢視時，嵌入式管理單元必須呼叫 IConsole2：：SelectScopeItem 以重新選取專案，並強制 MMC 再次呼叫 GetResultViewType 。這可讓嵌入式管理單元指定適當的自定義 OCX 或網頁，讓 MMC 可以載入它。從自定義檢視切換至標準清單檢視時，MMC 會自動呼叫 GetResultViewType 並設定適當的清單檢視類型。

指定 Unicode 字串時，字型連結功能會決定顯示該字串的最佳字型。例如，如果您使用伺服器名稱填入清單檢視，並知道半部是日文和俄文的一半，則您會設定字型連結檢視選項，而 MMC 會決定適當的字型。默認值不會使用字型連結，因為 MMC 搜尋適當的字型時會達到小型效能。

Cookie 是結構指標，其中包含特定專案唯一的資訊。它會透過 SCOPEDATAITEM 結構的 lParam 成員傳入。

規格需求

需求	值
最低支援的用戶端	Windows Vista
最低支援的伺服器	Windows Server 2008
目標平台	Windows
標頭	mmc.h

另請參閱

IComponent

IDataObject

共用方式為