共用方式為


MMCPropertyHelp 函式 (mmc.h)

MMCPropertyHelp 函式是在 MMC 1.1 中引進。

MMCPropertyHelp 函式會在屬性頁的合併 MMC HTML 說明檔中顯示指定的 HTML 說明主題。

語法

HRESULT MMCPropertyHelp(
  LPOLESTR pszHelpTopic
);

參數

pszHelpTopic

Null 終止字串的指標,指定要顯示在合併 MMC HTML 說明檔中的主題。 字串必須具有下列格式:

helpfilename::topicfilename

其中 helpfilename 是嵌入式管理單元 HTML 說明檔的檔案名 (.chm) 該 MMC 合併到 MMC HTML 說明檔 (檔案名,而不是原始 HTML 說明檔的路徑) , 而 topicfilename 是嵌入式管理單元 .chm 檔案內主題檔案的內部路徑。 嵌入式管理單元的 HTML 說明檔作者會決定主題 HTML 檔案是否有內部目錄結構,或所有主題 HTML 檔案是否位於 .chm 檔案的根目錄。

例如,如果嵌入式管理單元已將 HTML 說明檔 mysnapin.chm 合併到 MMC HTML 說明檔,以及具有 htm/snphlp01.htm 內部說明檔路徑的主題 HTML 檔案,則字串的格式如下:

mysnapin.chm::htm/snphlp01.htm

此版本不提供主題的數值識別碼支援。

傳回值

這個回呼函式可以傳回下列其中一個值。

備註

MMCN_CONTEXTHELP 通知的通知處理常式中呼叫 MMCPropertyHelp。

嵌入式管理單元可以在屬性頁面上提供內容說明。 因為 MMC 屬性工作表通常會在不同的執行緒上執行,所以屬性頁無法直接使用 IDisplayHelp 介面。 相反地,屬性頁可以從 MMC 程式庫呼叫 MMCPropertyHelp,以達到相同的結果。 MMCPropertyHelp 會採用與 IDisplayHelp::ShowTopic 相同的主題字串參數,並處理將要求封送處理至主要 MMC 執行緒。

如果嵌入式管理單元處理 MMCN_CONTEXTHELP 通知,MMC 預期嵌入式管理單元會指定所選項目的 [說明] 主題。 因此,在 MMCN_CONTEXTHELP 通知的通知處理常式中,嵌入式管理單元有兩個選項:

  • 它可以呼叫 IDisplayHelp::ShowTopicMMCPropertyHelp 來指定 [說明] 主題,然後傳回 S_OK 表示成功。 請注意,如果嵌入式管理單元指定說明主題,則應該只會傳回 S_OK 。 如果嵌入式管理單元傳回 S_OK 而不指定 [說明] 主題,則不會顯示 [說明] 主題。
  • 它可以將S_FALSE傳回通知。 MMC 接著會顯示已選取預設 MMC 主題的目錄。

需求

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

另請參閱

IDisplayHelp::ShowTopic

ISnapinHelp2::GetHelpTopic