如何註冊 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 檔案以保存這些連結的詳細資訊，請參閱建立主控台專案的可搜尋工作連結。

註冊主控台專案

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