com4:Extension

Fornisce funzionalità per esporre le registrazioni COM ai client all'esterno del pacchetto dell'app. L'estensione com4 è una nuova versione che è un superset di e la sostituzione per le versioni precedenti dello schema COM. Per altre informazioni, vedere la sezione Osservazioni.

Gerarchia degli elementi

pacchetto

     <applicazioni>

          dell'applicazione

               <extensions>

                    <com4:Extension>

     <extensions>

          <com4:Extension>

Sintassi

<com4:Extension
  Category = 'A string that can have one of the following values: "windows.comServer" or "windows.comInterface".'
  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 *.'
  EntryPoint = 'An optional string with a value between 1 and 256 characters in length that cannot start or end with a whitespace character.'
  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 *.'
  ResourceGroup = 'An optional alphanumeric string with a value between 1 and 255 characters in length. Must begin with a letter.'
  TrustLevel = 'An optional string the can have one of the following values: "appContainer" or "mediumIL".'
  RuntimeBehavior = 'An optional string the can have one of the following values: "windowsApp", "packagedClassicApp", or "win32App".'
  HostId = 'An optional alphanumeric string with a value between 1 and 255 characters in length. Must begin with a letter.'
  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 -->
  com4:ComServer
  com4:ComInterface

</com4:Extension>

Attributi ed elementi

Attributi

Elementi figlio

Elementi padre

Osservazioni

L'estensione com4 è essenzialmente una riscrittura della sintassi dell'estensione windows.comServer/windows.comInterface precedente. Questa estensione è un superset delle funzionalità di estensione com precedenti, con un comportamento identico per la sintassi ereditata. La convalida del manifesto per la nuova sintassi usata nella creazione di pacchetti è più allineata ai requisiti semantici dell'estensione.

• Nella versione precedente, ogni estensione è stata considerata come un documento separato, consentendo la convalida di chiavi non univoche e riferimenti incerti.
• Nella versione precedente, la duplicazione degli attributi soggetti a vincoli univoci/chiave è stata intercettata dalla convalida del manifesto solo se gli attributi duplicati vengono visualizzati nella stessa istanza dell'estensione. I pacchetti duplicati di questi attributi non riuscirebbero a essere distribuiti, con informazioni di diagnostica limitate per identificare il problema.
• Nella versione precedente, un keyref il cui referenziale si trova in un'istanza diversa dell'estensione verrebbe bloccato dalla convalida del manifesto, ovvero una restrizione artificiale rispetto al supporto del comportamento di distribuzione/runtime.

Le applicazioni destinate a Windows 11 che possono usare il nuovo spazio dei nomi com4 per tutte le estensioni windows.comServer/windows.comInterface devono usarlo. Non è consigliabile combinare il nuovo spazio dei nomi con gli spazi dei nomi precedenti, ad esempio:

• La distribuzione del pacchetto nelle versioni che supportano il nuovo spazio dei nomi gestirà le estensioni da tutti gli spazi dei nomi e tutti gli identificatori univoci duplicati tra le estensioni che usano versioni diverse dello spazio dei nomi genereranno un errore. L'uso degli spazi dei nomi meno recenti impedisce alla convalida del manifesto di rilevare questi errori.
• A causa delle limitazioni degli schemi dello spazio dei nomi meno recenti, un keyref nella sintassi precedente non può fare riferimento a una chiave nella nuova sintassi perché si trovano in istanze diverse dell'estensione.

L'uso della semantica della sintassi com4 seguente ha requisiti di funzionalità:

• CompatMode="classic" richiede Microsoft.classicAppCompat_8wekyb3d8bbwe
• Scope="machine" richiede Microsoft.classicAppCompatElevated_8wekyb3d8bbwe

Nell'esempio seguente viene illustrato come registrare un'implementazione out-of-process e un'implementazione del server in-process per la stessa classe.

Esempi

<com4:Class Id="f4ed7720-9b3a-44a4-xxxx-xxxxxxxxxxxx" DisplayName="CLSID_Foo"/> 
<com:ExeServer Executable="MyServer.exe" DisplayName="My server">  
  <com4:ClassReference Id="f4ed7720-9b3a-44a4-xxxx-xxxxxxxxxxxx"/>  
</com:ExeServer> 
<com4:InProcessServer Path="MyServer.dll">  
  <com4:ClassReference Id="f4ed7720-9b3a-44a4-xxxx-xxxxxxxxxxxx"/>  
</com4:InProcessServer> 

Nuove funzionalità nell'estensione com4

• Supporto per i server in-process (sia non gestiti che gestiti) e i gestori in-process personalizzati (ovvero, non per il gestore predefinito OLE). Questa funzionalità è attualmente limitata dal livello funzionale e limitata dai criteri:
  • Questo è attualmente destinato all'uso solo da pacchetti con posizione esterna; non funziona per la maggior parte dei pacchetti normali a causa degli ACL nel percorso di installazione che impediscono il caricamento delle DLL del pacchetto all'esterno del pacchetto. Per altre informazioni sui pacchetti con posizione esterna, vedere Concedere l'identità del pacchetto tramite creazione di pacchetti con percorso esterno.
• È ora possibile associare un TypeLib a una registrazione di classe.

Fabbisogno