Windows.System.User: add Remarks to FindAllAsync overloads and GetFromId

[GrantMeStrength]

Addresses ADO work item #311108 (GitHub issues #1144, #1742, #1195).

Changes

FindAllAsync (all three overloads)

• Added ## -remarks explaining that on desktop, the method returns at most one user (the interactive user in the caller's session); on Xbox, it may return multiple users. The method does not enumerate all accounts on the device.
• Added cross-reference to GetDefault (Windows 10, version 2104) as the preferred API for identifying the current process user.
• The deprecated FindAllAsync(UserType, UserAuthenticationStatus) overload now includes a [!WARNING] callout directing users to FindAllAsync or GetDefault.

GetFromId

• Added ## -remarks documenting that passing an unrecognized nonRoamableId returns null, and noting the device-specific nature of the identifier.

Not in this PR

Issue #1830 (GetPropertiesAsync — AAD AccountName/DomainName table accuracy) is tracked separately. The customer reports the AAD column may be wrong (AccountName available, DomainName not). The issue was 6 years old and lacked information and so was closed.

[Copilot]

Pull request overview

Updates Windows.System.User API reference docs to clarify platform-specific behavior of FindAllAsync overloads and GetFromId, aligning guidance with expected usage for identifying the current user and handling missing users.

Changes:

• Added remarks to all FindAllAsync overloads describing desktop vs Xbox results and clarifying that it doesn’t enumerate all device accounts.
• Added guidance to prefer User.GetDefault for identifying the current process user (and added a deprecation warning callout on the deprecated overload).
• Added GetFromId remarks documenting null return for unknown IDs and the device-specific nature of nonRoamableId.

Reviewed changes

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

File	Description
windows.system/user_getfromid_2093276151.md	Adds remarks about null return and device-specific nonRoamableId.
windows.system/user_findallasync_711678667.md	Adds platform behavior remarks + points to GetDefault; adjusts see-also formatting.
windows.system/user_findallasync_326280522.md	Adds platform behavior remarks + points to GetDefault; adjusts see-also formatting.
windows.system/user_findallasync_1333355945.md	Adds deprecation warning + platform behavior remarks; adjusts see-also formatting.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.