Ler en inglés

Compartir por

deployment:Extension (en Paquete/Extensiones)

  • Artigo

Declara un punto de extensibilidad para la aplicación que especifica un controlador de extensión de implementación no asignado (DEH).

Jerarquía de elementos

> del paquete de<

     <Applications>

          <Application>

               <extensiones>

                    <implementación:extensión>

Sintaxis

XML 
<deployment:Extension 
  Category = 'A string that can have one of the following values: "windows.deploymentExtensionHandler".'
  Executable = 'An optional string with a value between 1 and 256 characters in length that must end with ".exe" and cannot contain these characters: <, >, :, ", |, ?, or *. It specifies the default executable for the extension. If not specified, the executable defined for the app is used.  If specified, the EntryPoint property is also used. If that EntryPoint property isnt specified, the EntryPoint defined for the app is used.'
  EntryPoint = 'An optional string with a value between 1 and 256 characters in length, representing the  task handling the extension. This is normally the fully namespace-qualified name of a Windows Runtime type. If EntryPoint is not specified, the EntryPoint defined for the app is used instead.'
  RuntimeType = 'An optional string with a value between 1 and 255 characters in length that cannot start or end with a period or contain these characters: <, >, :, ", /, \, |, ?, or *.'
  StartPage = 'An optional string with a value between 1 and 256 characters in length that cannot contain these characters: <, >, :, ", |, ?, or *.'
  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 -->
  deployment:DeploymentExtensionHandler?

</deployment:Extension>

Llave

? opcional (cero o uno)

Atributos y elementos

Atributos

Atributo Descripción Tipo de dato Obligatorio Valor predeterminado
categoría Categoría de la extensión. Cadena que puede tener uno de los siguientes valores: windows.fileExplorerClassicContextMenuHandler o windows.fileExplorerClassicDragDropContextMenuHandler. Sí
ejecutable Ejecutable de inicio predeterminado. Cadena opcional con un valor de entre 1 y 256 caracteres de longitud que debe terminar con .exe y no puede contener estos caracteres: <, >, :, ", |, ?o *. Especifica el archivo ejecutable predeterminado para la extensión. Si no se especifica, se usa el archivo ejecutable definido para la aplicación. Si se especifica, también se usa la propiedad EntryPoint. Si no se especifica esa propiedad EntryPoint, se usa entryPoint definido para la aplicación. No
EntryPoint Identificador de clase activable. Cadena opcional con un valor entre 1 y 256 caracteres de longitud, que representa la tarea que controla la extensión. Normalmente es el nombre completo del espacio de nombres de un tipo de Windows Runtime. Si no se especifica EntryPoint, se usa en su lugar entryPoint definido para la aplicación. No
RuntimeType El proveedor en tiempo de ejecución. Este atributo se usa normalmente cuando hay marcos mixtos en una aplicación. Cadena opcional con un valor de entre 1 y 255 caracteres de longitud que no puede iniciar ni terminar con un punto o contener estos caracteres: <, >, :, ", /, \, |, ?o *. No
startPage de Página web que controla el punto de extensibilidad. Cadena opcional con un valor de entre 1 y 256 caracteres que no pueden contener estos caracteres: <, >, :, ", |, ?o *. No
uap10:TrustLevel Especifica el nivel de confianza de la extensión. Cadena opcional que puede tener uno de los siguientes valores: appContainer o mediumIL. No
uap10:RuntimeBehavior Especifica el comportamiento en tiempo de ejecución de la extensión. Cadena opcional que puede tener uno de los siguientes valores: windowsApp, empaquetadoClassicAppo win32App. No
uap10:HostId Especifica el identificador del entorno de ejecución del host para la extensión. Cadena alfanumérica con un valor entre 1 y 255 caracteres de longitud. Debe comenzar con una letra. No
uap10:Parameters Contiene parámetros de línea de comandos para pasar a la extensión. Solo se admite para las aplicaciones de escritorio que tienen identidad de paquete. Cadena opcional con un valor entre 1 y 32767 caracteres de longitud con un carácter de espacio no en blanco al principio y al final. No
uap11:Id Identificador de la extensión. El identificador debe ser único para todas las extensiones de un paquete. Cadena opcional con un valor entre 1 y 255 caracteres de longitud con un carácter de espacio no en blanco al principio y al final. No
uap11:Subsystem Subsistema de destino de la extensión. Cadena opcional que puede tener uno de los siguientes valores: consola o ventanas. No
uap11:SupportsMultipleInstances Especifica si las instancias deben ejecutarse en distintos procesos. El valor predeterminado es false. Valor booleano opcional. No
uap11:ResourceGroup Etiqueta que puede usar para agrupar las activaciones de extensión con fines de administración de recursos (por ejemplo, CPU y memoria). El valor que puede establecer ResourceGroup es de forma libre y flexible. Consulte Application@ResourceGroup. Cadena alfanumérica opcional con un valor entre 1 y 255 caracteres de longitud. Debe comenzar con una letra. No
uap11:CurrentDirectoryPath Especifica el directorio inicial cuando se inicia el proceso de aplicación. Este atributo admite macros. Para obtener más información, consulta Macros en el esquema de manifiesto del paquete. Cadena opcional que no puede contener estos caracteres: <, >, |, ?o *. > No
uap11:Parameters Subsistema de destino de la extensión. Este atributo admite macros. Para obtener más información, consulta Macros en el esquema de manifiesto del paquete. Cadena opcional con un valor entre 1 y 32767 caracteres de longitud con un carácter de espacio no en blanco al principio y al final. No
desktop7:CompatMode Especifica si la información de esta extensión se registra con Windows de maneras clásicas (por ejemplo, aplicaciones sin empaquetar con COM a través del Registro) o de nuevas formas más limitadas. El valor predeterminado es "moderno". CompatMode="classic" requiere la funcionalidad Microsoft.classicAppCompat_8wekyb3d8bbwe. Una cadena opcional puede tener uno de los siguientes valores: clásico o moderno. No
desktop7:Scope Especifica si los registros solo son visibles para otras aplicaciones que se ejecutan como un usuario que tiene este paquete registrado (usuario) o si son visibles para todos los usuarios y servicios del equipo (máquina). El valor predeterminado es "user". Scope="machine" requiere la funcionalidad Microsoft.classicAppCompatElevated_8wekyb3d8bbwe. Cadena opcional que puede tener uno de los siguientes valores: máquina o usuario. No

Elementos secundarios

Elemento secundario Descripción
DeploymentExtensionHandler Permite a una aplicación especificar uno o varios archivos DLL que proporcionan funcionalidad de DEH que se distribuye fuera de una versión del sistema operativo.

Elementos primarios

Elemento primario Descripción
extensiones de Define uno o varios puntos de extensibilidad para la aplicación.

Observaciones

Un DEH permite a las aplicaciones acceder a puntos de extensibilidad en el sistema operativo. Un DEH no asignado es uno que se distribuye fuera de una versión del sistema operativo. Esta es la extensión no está pensada para su uso por parte de los desarrolladores de terceros.

Ejemplos

En el ejemplo siguiente se muestra el uso del elemento DeploymentExtensionHandler dentro de un archivo de manifiesto de paquete para registrar un DEH no asignado.

XML 
<Extension Category=”windows.deploymentExtensionHandler”> 
  <DeploymentExtensionHandler> 
    <Files> 
      <File>path/to/UndockedDEH.dll </File> 
      <File>path/to/UndockedDEH2.dll </File> 
    </Files> 
  </DeploymentExtensionHandler> 
</Extension>

Requisitos

Artículo Valor
Namespace http://schemas.microsoft.com/appx/manifest/deployment/windows10
uap10 http://schemas.microsoft.com/appx/manifest/uap/windows10/10
uap11 http://schemas.microsoft.com/appx/manifest/uap/windows10/11
de escritorio de 7 http://schemas.microsoft.com/appx/manifest/desktop/windows10/7
versión mínima del sistema operativo Windows 10 (compilación 20348)