套件/擴充功能) (Windows 10) 中的擴充功能 (

宣告封裝的擴充點。

元素階層

<套件>

    <擴充功能>

         <擴展>

Syntax

<Extension
  Category = 'A string that can have one of the following values: "windows.activatableClass.inProcessServer", "windows.activatableClass.outOfProcessServer", "windows.activatableClass.proxyStub", "windows.certificates", "windows.publisherCacheFolders", "windows.comInterface", or "windows.loaderSearchPathOverride".'
  uap10:TrustLevel = 'An optional string that can have one of the following values: "appContainer" or "mediumIL".'
  uap10:RuntimeBehavior = 'An optional string that can have one of the following values: "windowsApp", "packagedClassicApp", or "win32App".'
  uap10:HostId = 'An alphanumeric string with a value between 1 and 255 characters in length. Must begin with a letter.'
  uap10:Parameters = 'An optional string with a value between 1 and 32767 characters in length with a non-whitespace character at its beginning and end.' 
  uap11:Id = 'An optional string with a value between 1 and 255 characters in length with a non-whitespace character at its beginning and end.'
  uap11:Subsystem = 'An optional string that can have one of the following values: "console" or "windows".'
  uap11:SupportsMultipleInstances = 'An optional boolean value.'
  uap11:ResourceGroup = 'An optional alphanumeric string with a value between 1 and 255 characters in length. Must begin with a letter.'
  uap11:CurrentDirectoryPath = 'An optional string that cannot contain these characters: <, >, |, ?, or *. >'
  uap11:Parameters = 'An optional string with a value between 1 and 32767 characters in length with a non-whitespace character at its beginning and end.'
  desktop7:CompatMode = 'An optional string the can have one of the following values: "classic" or "modern".'
  desktop7:Scope = 'An optional string that can have one of the following values: "machine" or "user".'>

  <!-- Child elements -->
  InProcessServer
  OutOfProcessServer
  ProxyStub
  Certificates
  PublisherCacheFolders
  com:ComInterface
  uap6:LoaderSearchPathOverride

</Extension>

屬性和元素

屬性

屬性	描述	資料類型	必要	預設值
類別	套件擴充點的類型。	可具有下列其中一個值的字串： windows.enableableClass.inProcessServer、 windows.enableableClass.outOfProcessServer、 windows.enableableClass.proxyStub、 windows.certificates、 windows.publisherCacheFolders、 windows.comInterface 或 windows.loaderSearchPathOverride	Yes
uap10：TrustLevel	指定延伸模組的信任層級。	可具有下列其中一個值的選擇性字串： appContainer 或 mediumIL。	No
uap10：RuntimeBehavior	指定延伸模組的運行時間行為。	可具有下列其中一個值的選擇性字串： windowsApp、 packagedClassicApp 或 win32App。	No
uap10：HostId	此值 指定擴充功能的主機運行時間標識碼。	長度介於 1 到 255 個字元之間的英數位元字串。 必須以字母開頭。
uap10：Parameters	包含延伸模組的命令行參數。	長度介於 1 到 32767 個字元之間的字串，其開頭和結尾具有非空格符。	No
uap11：Id	延伸模組的標識碼。 套件中所有延伸模組的標識碼都必須是唯一的。	長度介於 1 到 255 個字元的選擇性字串，其開頭和結尾具有非空格符。	No
uap11：子系統	此屬性繼承自基底延伸模組語法，不適用於 com4 延伸模組。 除了語法驗證之外，也會忽略此值。	可具有下列其中一個值的選擇性字串： 控制台 或 視窗。	No
uap11：SupportsMultipleInstances	指定實例是否應該在不同的進程中執行。 預設值為 false。	選擇性布爾值。	No
uap11：ResourceGroup	標記，可用來將擴充功能啟用群組在一起，以供資源管理之用 (，例如 CPU 和記憶體) 。 您可以設定 ResourceGroup 的值是自由格式且有彈性。 請參閱 Application@ResourceGroup。	長度介於 1 到 255 個字元之間的選擇性英數位元字串。 必須以字母開頭。	No
uap11：CurrentDirectoryPath	指定應用程式進程啟動時的初始目錄。 此屬性支持宏。 如需詳細資訊，請參閱 套件指令清單架構中的宏。	無法包含下列字元的選擇性字串：<、、、>|、 ?或 *。 >	No
uap11：Parameters	此屬性繼承自基底延伸模組語法，不適用於 com4 延伸模組。 除了語法驗證之外，也會忽略此值。 此屬性支持宏。 如需詳細資訊，請參閱 套件指令清單架構中的宏。	長度介於 1 到 32767 個字元的選擇性字串，其開頭和結尾為非空格符。	No
desktop7：CompatMode	指定此延伸模組的資訊是以傳統方式向 Windows 註冊， (例如，透過登錄) 或以更具範圍的方式向 COM 註冊未封裝的應用程式註冊類型。 預設值為 「modern」。 CompatMode=“classic” 需要 Microsoft.classicAppCompat_8wekyb3d8bbwe 功能。	的選擇性字串可以有下列其中一個值： 傳統 或 新式。	No
desktop7：Scope	指定註冊是否只有以使用者身分註冊 (使用者) 執行的其他應用程式，或是否對 (計算機上的所有使用者和服務顯示註冊) 。 預設值為 「user」。 Scope=“machine” 需要 Microsoft.classicAppCompatElevated_8wekyb3d8bbwe 功能。	可具有下列其中一個值的選擇性字串： 計算機 或 使用者。	No

子元素

子項目	描述
憑證	宣告 windows.certificates 類型的套件擴充點。 應用程式需要來自指定證書存儲的一或多個憑證。
InProcessServer	宣告 windows.enableableClass.inProcessServer 類型的套件擴充點。 應用程式會使用動態連結庫 () .dll 來公開一或多個可啟用的類別。
OutOfProcessServer	宣告 windows.enableableClass.outOfProcessServer 類型的套件延伸點。 應用程式會使用公開一或多個可啟用類別的可執行檔 (.exe) 。
ProxyStub	宣告 windows.activatableClass.proxyStub 類型的套件擴充點。 Proxy 可以由一或多個介面組成。
PublisherCacheFolders	宣告 windows.publisherCacheFolders 類型的套件擴充點。 這會指定套件與相同發行者的其他套件共用的一或多個資料夾。
com:ComInterface	宣告 windows.comInterface 類型的套件擴充點。
uap6:LoaderSearchPathOverride	宣告 windows.loaderSearchPathOverride 類型的套件擴充點。

父元素

父元素	描述
延伸模組 (類型：CT_PackageExtensions)	定義封裝的一或多個擴充點。

相關元素

下列元素的名稱與這個元素相同，但內容或屬性不同：

• 擴充功能 (全域)

備註

擴充點是一種機制，套件可以透過操作系統所定義的方式來新增功能。 擴充點是應用程式可以註冊以執行程式碼或使用目前套件資源的位置。 若要新增特定應用程式的功能，請使用Applications元素的Application子元素。

無法在指令清單中多次宣告 windows.certificates 擴充點。

另請參閱

• 應用程式協定與擴充功能

規格需求

Item	值
Namespace	http://schemas.microsoft.com/appx/manifest/foundation/windows10
Com	http://schemas.microsoft.com/appx/manifest/com/windows10
uap6	http://schemas.microsoft.com/appx/manifest/uap/windows10/10