Skip to content

Document COM server support in MSIX packages - #505

Draft
Roy (RDMacLachlan) wants to merge 3 commits into
MicrosoftDocs:mainfrom
RDMacLachlan:users/romaclac/docbug-26070760
Draft

Document COM server support in MSIX packages#505
Roy (RDMacLachlan) wants to merge 3 commits into
MicrosoftDocs:mainfrom
RDMacLachlan:users/romaclac/docbug-26070760

Conversation

@RDMacLachlan

Copy link
Copy Markdown
Collaborator

Add focused guidance for COM server, interface, and type library manifest registration in MSIX packages. Reference ADO bug 26070760.

Add focused guidance for COM server, interface, and type library manifest registration in MSIX packages. Reference ADO bug 26070760.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Copilot-Session: 4b5b11f6-6bf8-4401-90b8-68f710728c8e
@learn-build-service-prod

Copy link
Copy Markdown
Contributor

Learn Build status updates of commit 28a4ed5:

✅ Validation status: passed

File Status Preview URL Details
msix-src/desktop/com-support.md ✅Succeeded
msix-src/desktop/extend-overview.md ✅Succeeded
msix-src/toc.yml ✅Succeeded

For more details, please refer to the build report.

Comment thread msix-src/desktop/com-support.md

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Adds a new documentation page describing how to declare COM servers, interfaces, proxy stubs, and type libraries in MSIX package manifests (focused on the com4 schema), and links it into the desktop packaging docs navigation.

Changes:

  • Add new conceptual article: COM support in MSIX packages with schema guidance, scenario table, and a manifest example.
  • Add navigation entry in toc.yml under “Key concepts to know before packaging”.
  • Add the new article to the “Extend your packaged applications” overview table.

Reviewed changes

Copilot reviewed 3 out of 3 changed files in this pull request and generated 3 comments.

File Description
msix-src/toc.yml Adds the new COM support article to the desktop packaging TOC.
msix-src/desktop/extend-overview.md Adds a link to the new COM support article in the extension overview table.
msix-src/desktop/com-support.md New documentation page describing packaged COM registration via com4 manifest extensions, including an example and reference links.

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

Comment thread msix-src/desktop/com-support.md Outdated
Comment on lines +39 to +42
The `com4` schema is a superset and replacement for the older `com`, `com2`, and `com3`
syntax. Use `com4` for new Windows 11 package manifests that can depend on Windows 10
Build 20348 or later. If your package must install on earlier Windows versions, review the
older namespace schema and validate the manifest against every target OS version.

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Clarified. The paragraph now cites the [com4:Extension schema reference] for the minimum OS version, notes that build 20348 is the Windows Server 2022 build, states Windows 11 meets the requirement, and frames the guidance as "use com4 when your app targets Windows 11 or later."

Comment thread msix-src/desktop/com-support.md
Comment thread msix-src/desktop/com-support.md Outdated
Comment on lines +163 to +165
<!-- SME question: Should this article include a tested example for multiple com4:Version
children under one com4:TypeLib, including the expected behavior when a class references one
VersionNumber? -->

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The trailing HTML "SME question" comment is no longer in the file (removed in the current revision), so it won't ship in the published markdown.

Clarify com4 version support, complete the schema links, and remove internal notes.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@learn-build-service-prod

Copy link
Copy Markdown
Contributor

Learn Build status updates of commit c62ed0d:

✅ Validation status: passed

File Status Preview URL Details
msix-src/desktop/com-support.md ✅Succeeded
msix-src/desktop/extend-overview.md ✅Succeeded
msix-src/toc.yml ✅Succeeded

For more details, please refer to the build report.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Copilot-Session: 485b92b6-ded3-49ac-8734-e0badb78eb39
@learn-build-service-prod

Copy link
Copy Markdown
Contributor

Learn Build status updates of commit b651193:

✅ Validation status: passed

File Status Preview URL Details
msix-src/desktop/com-support.md ✅Succeeded
msix-src/desktop/extend-overview.md ✅Succeeded
msix-src/toc.yml ✅Succeeded

For more details, please refer to the build report.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants