diff --git a/windows.management.deployment/packagemanager_findpackages_1246181969.md b/windows.management.deployment/packagemanager_findpackages_1246181969.md index 1ad7314f1..9ccb0cb86 100644 --- a/windows.management.deployment/packagemanager_findpackages_1246181969.md +++ b/windows.management.deployment/packagemanager_findpackages_1246181969.md @@ -10,7 +10,7 @@ public Windows.Foundation.Collections.IIterable [!NOTE] +> Parameter formats matter — passing the wrong format silently returns an empty collection: +> +> - The *packageName* parameter corresponds to [Package.Id.Name](/uwp/api/windows.applicationmodel.packageid.name) — for example, `Microsoft.WindowsCalculator`. This is **not** [Package.Id.FullName](/uwp/api/windows.applicationmodel.packageid.fullname) (which includes version and architecture). +> - The *packagePublisher* parameter corresponds to [Package.Id.Publisher](/uwp/api/windows.applicationmodel.packageid.publisher) — the full X.500 distinguished name string, for example, `CN=Microsoft Corporation, O=Microsoft Corporation, L=Redmond, S=Washington, C=US`. This is **not** [Package.Id.PublisherId](/uwp/api/windows.applicationmodel.packageid.publisherid) (the hashed short form). +> +> Use [FindPackages(String)](packagemanager_findpackages_331793265.md) with [Package.Id.FamilyName](/uwp/api/windows.applicationmodel.packageid.familyname) as a simpler and less error-prone alternative when you don't need to match on publisher separately. ## -examples diff --git a/windows.management.deployment/packagemanager_findpackages_331793265.md b/windows.management.deployment/packagemanager_findpackages_331793265.md index 70d937309..2c3a06322 100644 --- a/windows.management.deployment/packagemanager_findpackages_331793265.md +++ b/windows.management.deployment/packagemanager_findpackages_331793265.md @@ -22,6 +22,9 @@ If the method succeeds, an enumerable collection of package objects with the sam ## -remarks This method requires administrative privileges. Each package in the [IIterable(Package)](../windows.foundation.collections/iiterable_1.md) collection may be installed for the current user or for another user. This method differs from [FindPackages(String packageName, String pulisherName)](packagemanager_findpackages_1597689551.md) method. Here the *packageFamilyName* parameter is a single string, comprised of the package name and package publisher hash. +> [!NOTE] +> The *packageFamilyName* parameter corresponds to [Package.Id.FamilyName](/uwp/api/windows.applicationmodel.packageid.familyname) — for example, `Microsoft.WindowsCalculator_8wekyb3d8bbwe`. This is **not** the same as [Package.Id.Name](/uwp/api/windows.applicationmodel.packageid.name) (e.g., `Microsoft.WindowsCalculator`) or [Package.Id.FullName](/uwp/api/windows.applicationmodel.packageid.fullname) (which includes version and architecture). Passing an incorrect format silently returns an empty collection. + ## -examples ## -see-also