共用方式為


如何註冊 DLL 主控台專案

注意

目前的實作指導方針指出,新的主控台專案應該實作為.exe檔案,而不是.cpl檔案。 下列資訊主要適用于舊版用途。

 

主控台匯出CPlApplet函式之 DLL 中實作的專案,其註冊需求與.exe檔案不同。 從 Windows XP 開始,新的主控台專案 DLL 應該安裝在相關聯的應用程式資料夾的 [Program Files] 資料夾下。 使用 .cpl 擴充功能儲存在 System32 目錄中的專案不需要註冊;它們會自動顯示在主控台中。 使用CPlApplet的其他所有主控台專案都必須以下列兩種方式之一註冊:

  • 如果主控台專案可供所有使用者使用,請將REG_EXPAND_SZ值新增至HKEY_LOCAL_MACHINE\Software\Microsoft\Windows\CurrentVersion\主控台\Cpls子機碼,以依每部電腦註冊路徑。
  • 如果每個使用者都可以使用主控台專案,請使用HKEY_CURRENT_USER作為根索引鍵,而不是HKEY_LOCAL_MACHINE

下列兩個範例會註冊MyCplApp主控台專案。 DLL 名為 MyCpl.cpl,位於 MyCorp\MyApp 應用程式目錄中。 第一個範例說明每部電腦註冊。

指示

步驟 1:

將此資訊新增至登錄,以註冊.cpl檔案是否存在。

HKEY_LOCAL_MACHINE
   Software
      Microsoft
         Windows
            CurrentVersion
               Control Panel
                  Cpls
                     MyCpl = [REG_EXPAND_SZ] %ProgramFiles%\MyCorp\MyApp\MyCpl.cpl

步驟 2:

Windows Vista 和更新版本:將此其他資訊新增至登錄,以提供主控台專案的 GUID。

HKEY_LOCAL_MACHINE
   Software
      Microsoft
         Windows
            CurrentVersion
               Control Panel
                  Extended Properties
                     System.Software.AppId
                        %ProgramFiles%\MyCorp\MyApp\MyCpl.cpl = {A newly generated GUID}

藉由產生 GUID 來唯一識別主控台專案,您可以將工作連結新增至主控台。 如果沒有這個 GUID,就無法讓工作連結與主控台專案產生關聯。 請參閱建立主控台專案的可搜尋工作連結

步驟 3:

Windows Vista 和更新版本: 將下列資訊新增至登錄,以建立專案的正式名稱。

HKEY_LOCAL_MACHINE
   Software
      Microsoft
         Windows
            CurrentVersion
               Control Panel
                  Extended Properties
                     System.ApplicationName
                        %ProgramFiles%\MyCorp\MyApp\MyCpl.cpl = [REG_SZ] MyCorporation.MyCpl

藉由新增標準名稱,使用者可以輸入 , control.exe /name MyCorporation.MyCpl 從命令列啟動主控台專案。 這也可讓您在稍後將實作從.cpl檔案變更為.exe檔案,而不需要呼叫程式進行任何變更,因為它們可以繼續透過其標準名稱開啟專案。 如需標準名稱的詳細資訊,請參閱執行主控台專案

步驟 4:

Windows Vista 和更新版本:將下列資訊新增至登錄,以將主控台專案指派給一或多個類別。

HKEY_LOCAL_MACHINE
   Software
      Microsoft
         Windows
            CurrentVersion
               Control Panel
                  Extended Properties
                     System.ControlPanel.Category
                        %ProgramFiles%\MyCorp\MyApp\MyCpl.cpl = [REG_DWORD] 3

Windowsxp:將下列資訊新增至登錄,以將主控台專案指派給一或多個類別。

HKEY_LOCAL_MACHINE
   Software
      Microsoft
         Windows
            CurrentVersion
               Control Panel
                  Extended Properties
                     {305CA226-D286-468e-B848-2B2E8E697B74} 2
                        %ProgramFiles%\MyCorp\MyApp\MyCpl.cpl = [REG_DWORD] 3

本範例會將專案指派給類別 3,也就是網路和網際網路。 若要將專案新增至多個類別,請提供清單做為以逗號分隔的REG_SZ值,例如 「3,8」。 值可以做為十進位或十六進位提供。 請注意,只有 Windows XP Service Pack 2 (SP2) 和更新版本才能將專案新增至多個類別。 如需所有可能的值,請參閱指派主控台類別

步驟 5:

Windows Vista 和更新版本: 將下列資訊新增至登錄,以建立並指向 XML 檔案,以保存專案的工作連結。 此值必須是REG_SZ路徑,例如「C:\Program Files\MyCorp\MyApp\MyApp.exe,-31」) 為內嵌資源,則為模組 (和資源識別碼。 XML 檔案的位置應該完整指定。 它無法使用環境變數,例如 %ProgramFiles%。

HKEY_LOCAL_MACHINE
   Software
      Microsoft
         Windows
            CurrentVersion
               Control Panel
                  Extended Properties
                     System.Software.TasksFileUrl
                        %ProgramFiles%\MyCorp\MyApp\MyCpl.cpl = [REG_SZ] C:\ProgramFiles\MyCorp\MyApp\MyTasks.xml

如需工作連結以及如何建立 XML 檔案以保存這些連結的詳細資訊,請參閱建立主控台專案的可搜尋工作連結

註冊主控台專案

如何註冊可執行檔主控台專案