Merge remote-tracking branch 'public/docs'

jwmsft · jwmsft · commit 6e6458425fa1 · 2026-01-14T17:15:59.000-07:00
diff --git a/windows.applicationmodel.store/currentapp_requestapppurchaseasync_2023276791.md b/windows.applicationmodel.store/currentapp_requestapppurchaseasync_2023276791.md
@@ -10,6 +10,9 @@ public Windows.Foundation.IAsyncOperation<string> RequestAppPurchaseAsync(System
 # Windows.ApplicationModel.Store.CurrentApp.RequestAppPurchaseAsync
 
 ## -description
+> [!IMPORTANT]
+> In-app purchase functionality is not supported in evelated applications.
+
 Requests the purchase of a full app license.
 
 ## -parameters
diff --git a/windows.applicationmodel.store/currentapp_requestproductpurchaseasync_1631257175.md b/windows.applicationmodel.store/currentapp_requestproductpurchaseasync_1631257175.md
@@ -10,6 +10,9 @@ public Windows.Foundation.IAsyncOperation<string> RequestProductPurchaseAsync(Sy
 # Windows.ApplicationModel.Store.CurrentApp.RequestProductPurchaseAsync
 
 ## -description
+> [!IMPORTANT]
+> In-app purchase functionality is not supported in evelated applications.
+
 > [!NOTE]
 > [RequestProductPurchaseAsync(String, Boolean) may be altered or unavailable for releases after Windows 8.1. Instead, use [RequestProductPurchaseAsync(String)](currentapp_requestproductpurchaseasync_2091240017.md).
 
diff --git a/windows.applicationmodel.store/currentapp_requestproductpurchaseasync_1934617021.md b/windows.applicationmodel.store/currentapp_requestproductpurchaseasync_1934617021.md
@@ -10,6 +10,9 @@ public Windows.Foundation.IAsyncOperation<Windows.ApplicationModel.Store.Purchas
 # Windows.ApplicationModel.Store.CurrentApp.RequestProductPurchaseAsync
 
 ## -description
+> [!IMPORTANT]
+> In-app purchase functionality is not supported in evelated applications.
+
 Requests the purchase of an add-on (also called an in-app product or IAP). Additionally, calling this method displays the UI that is used to complete the transaction via the Microsoft Store. This overload includes parameters you can use to display details for a specific offer within a large catalog of in-app purchases that is represented by a single product entry in the Store.
 
 ## -parameters
diff --git a/windows.applicationmodel.store/currentapp_requestproductpurchaseasync_2091240017.md b/windows.applicationmodel.store/currentapp_requestproductpurchaseasync_2091240017.md
@@ -10,6 +10,9 @@ public Windows.Foundation.IAsyncOperation<Windows.ApplicationModel.Store.Purchas
 # Windows.ApplicationModel.Store.CurrentApp.RequestProductPurchaseAsync
 
 ## -description
+> [!IMPORTANT]
+> In-app purchase functionality is not supported in evelated applications.
+
 Requests the purchase of an add-on (also called an in-app product or IAP). Additionally, calling this method displays the UI that is used to complete the transaction via the Microsoft Store.
 
 ## -parameters
diff --git a/windows.applicationmodel.store/currentappsimulator_requestapppurchaseasync_2023276791.md b/windows.applicationmodel.store/currentappsimulator_requestapppurchaseasync_2023276791.md
@@ -10,6 +10,9 @@ public Windows.Foundation.IAsyncOperation<string> RequestAppPurchaseAsync(System
 # Windows.ApplicationModel.Store.CurrentAppSimulator.RequestAppPurchaseAsync
 
 ## -description
+> [!IMPORTANT]
+> In-app purchase functionality is not supported in evelated applications.
+
 Creates the async operation that simulates a user request to buy a full license for the current app.
 
 ## -parameters
diff --git a/windows.applicationmodel.store/currentappsimulator_requestproductpurchaseasync_1631257175.md b/windows.applicationmodel.store/currentappsimulator_requestproductpurchaseasync_1631257175.md
@@ -10,6 +10,9 @@ public Windows.Foundation.IAsyncOperation<string> RequestProductPurchaseAsync(Sy
 # Windows.ApplicationModel.Store.CurrentAppSimulator.RequestProductPurchaseAsync
 
 ## -description
+> [!IMPORTANT]
+> In-app purchase functionality is not supported in evelated applications.
+
 > [!NOTE]
 > [RequestProductPurchaseAsync(String, Boolean) may be altered or unavailable for releases after Windows 8.1. Instead, use [RequestProductPurchaseAsync(String)](currentappsimulator_requestproductpurchaseasync_2091240017.md).
 
diff --git a/windows.applicationmodel.store/currentappsimulator_requestproductpurchaseasync_1934617021.md b/windows.applicationmodel.store/currentappsimulator_requestproductpurchaseasync_1934617021.md
@@ -10,6 +10,9 @@ public Windows.Foundation.IAsyncOperation<Windows.ApplicationModel.Store.Purchas
 # Windows.ApplicationModel.Store.CurrentAppSimulator.RequestProductPurchaseAsync
 
 ## -description
+> [!IMPORTANT]
+> In-app purchase functionality is not supported in evelated applications.
+
 Creates the async operation that displays the UI that is used to simulate the purchase of an add-on (also called an in-app product or IAP) from the Microsoft Store. This overload includes parameters you can use to display details for a specific offer within a large catalog of in-app purchases that is represented by a single product entry in the Store.
 
 ## -parameters
diff --git a/windows.applicationmodel.store/currentappsimulator_requestproductpurchaseasync_2091240017.md b/windows.applicationmodel.store/currentappsimulator_requestproductpurchaseasync_2091240017.md
@@ -10,6 +10,9 @@ public Windows.Foundation.IAsyncOperation<Windows.ApplicationModel.Store.Purchas
 # Windows.ApplicationModel.Store.CurrentAppSimulator.RequestProductPurchaseAsync
 
 ## -description
+> [!IMPORTANT]
+> In-app purchase functionality is not supported in evelated applications.
+
 Creates the async operation that displays the UI that is used to simulate the purchase of an add-on (also called an in-app product or IAP) from the Microsoft Store.
 
 ## -parameters
diff --git a/windows.applicationmodel.store/windows_applicationmodel_store.md b/windows.applicationmodel.store/windows_applicationmodel_store.md
@@ -8,6 +8,9 @@
 ## -description
 Provides types and members for interacting with the Windows Store to add in-app purchases and trial functionality to your Universal Windows Platform (UWP) app.  
 
+> [!IMPORTANT] 
+> In-app purchase and in-app ratings functionalities are not currently supported in elevated applications.
+
 > [!NOTE]
 > The **Windows.ApplicationModel.Store** namespace is no longer being updated with new features. If your project targets **Windows 10 Anniversary Edition (10.0; Build 14393)** or a later release in Visual Studio (that is, you are targeting Windows 10, version 1607, or later), we recommend that you use the [Windows.Services.Store](../windows.services.store/windows_services_store.md) namespace instead. For more information, see [In-app purchases and trials](/windows/uwp/monetize/in-app-purchases-and-trials). The **Windows.ApplicationModel.Store** namespace is not supported in Windows desktop applications that use the [Desktop Bridge](https://developer.microsoft.com/windows/bridges/desktop) or in apps or games that use a development sandbox in [Partner Center](https://partner.microsoft.com/dashboard) (for example, this is the case for any game that integrates with Xbox Live). These products must use the [Windows.Services.Store](../windows.services.store/windows_services_store.md) namespace to implement in-app purchases and trials.
 
diff --git a/windows.devices.display.core/displaytarget_stablemonitorid.md b/windows.devices.display.core/displaytarget_stablemonitorid.md
@@ -11,13 +11,19 @@ public string StableMonitorId { get; }
 # Windows.Devices.Display.Core.DisplayTarget.StableMonitorId
 
 ## -description
-Gets a value representing a stable monitor identifier.
+Gets a value representing a stable identifier string for this monitor which persists no matter which adapter or connector on the adapter the monitor is attached to (see Remarks for exceptions). This string should be treated as an opaque identifier and not parsed. It is not suitable for display to a user but is intended to be used to persist monitor-specific settings.
 
 ## -property-value
 A string containing the identifier.
 
 ## -remarks
+Note that [DeviceInterfacePath](displaytarget_deviceinterfacepath.md) does not have this same stability guarantee. Reconnecting the same monitor to a different GPU or a different output on the same GPU can result in the monitor having a different DeviceInterfacePath, but the StableMonitorId should be maintained.
+
+In cases where the system detects two completely identical monitors connected at the same time, the stable identifier will be regenerated to include a reference to its connector to ensure that both monitors have a unique identifier.
+
+Some monitors may expose different hardware identifier information for each input port on the monitor. In this case, the StableMonitorId may vary depending on which input port on the monitor is used.
 
 ## -see-also
 
 ## -examples
+
diff --git a/windows.globalization.datetimeformatting/datetimeformatter_datetimeformatter_1042679024.md b/windows.globalization.datetimeformatting/datetimeformatter_datetimeformatter_1042679024.md
@@ -25,15 +25,15 @@ The list of language identifiers, in priority order, that represent the choice o
 
 ### -param geographicRegion
 
-The identifier for the geographic region. This identifier is used for resolving the template to a pattern.
+The identifier for a [GeographicRegion](windows.globalization.geographicregion.md) used to resolve the template to a pattern. This should be an ISO 3166-1 two-letter or three-letter code that identifies the country, or one of the three-digit UN-M49 codes that identify the geographical region.
 
 ### -param calendar
 
-The calendar identifier to use.
+The calendar identifier to use. This should be a value from [CalendarIdentifiers](windows.globalization.calendaridentifiers.md).
 
 ### -param clock
 
-The clock identifier to use.
+The clock identifier to use. This should be a value from [ClockIdentifiers](windows.globalization.clockidentifiers.md).
 
 ## -remarks
 
diff --git a/windows.services.store/storeavailability_requestpurchaseasync_1696674465.md b/windows.services.store/storeavailability_requestpurchaseasync_1696674465.md
@@ -15,6 +15,9 @@ Requests the purchase of the current SKU availability and displays the UI that i
 > [!IMPORTANT]
 > This method must be called on the UI thread.
 
+> [!IMPORTANT]
+> In-app purchase functionality is not supported in evelated applications.
+
 ## -returns
 An asynchronous operation that, on successful completion, returns a [StorePurchaseResult](storepurchaseresult.md) object that provides status and error info about the purchase.
 
diff --git a/windows.services.store/storeavailability_requestpurchaseasync_1703896342.md b/windows.services.store/storeavailability_requestpurchaseasync_1703896342.md
@@ -15,6 +15,9 @@ Requests the purchase of the current SKU availability and displays the UI that i
 > [!IMPORTANT]
 > This method must be called on the UI thread.
 
+> [!IMPORTANT]
+> In-app purchase functionality is not supported in evelated applications.
+
 ## -parameters
 ### -param storePurchaseProperties
 An object that specifies additional info for the purchase request, including the product name to display to the user during the purchase.
diff --git a/windows.services.store/storecontext_getappandoptionalstorepackageupdatesasync_399599716.md b/windows.services.store/storecontext_getappandoptionalstorepackageupdatesasync_399599716.md
@@ -18,13 +18,26 @@ An asynchronous operation that, on successful completion, returns a collection o
 ## -remarks
 For more information about using this method, including a code example, see [Download and install package updates for your app](/windows/uwp/packaging/self-install-package-updates).
 
-There is a latency of up to a day between the time when a package passes the certification process and when the GetAppAndOptionalStorePackageUpdatesAsync method recognizes that the package update is available to the app.
-
 After you call GetAppAndOptionalStorePackageUpdatesAsync to determine which packages have updates available, you can call [RequestDownloadStorePackageUpdatesAsync](storecontext_requestdownloadstorepackageupdatesasync_889669938.md) to download the updated packages or you can call [RequestDownloadAndInstallStorePackageUpdatesAsync](storecontext_requestdownloadandinstallstorepackageupdatesasync_1750789617.md) to download and install the updated packages.
 
 > [!IMPORTANT]
 > Optional packages and downloadable content (DLC) packages are not available to all developer accounts.
 
+## Update availability
+
+After you publish an app update in Partner Center, there can be a short delay between when the package passes certification and when the GetAppAndOptionalStorePackageUpdatesAsync method recognizes that the update is available. Most updates become available within a couple hours, but some publishing and distribution steps may take longer to finish in certain cases.
+
+### Detection frequency
+
+This API limits how often it checks for new updates. When an app calls the method more frequently than the allowed rate, the method returns the last known status instead of performing a new check.
+
+The current limits are:
+
+- No more than one check every 30 minutes.
+- No more than ten checks within any 24-hour period.
+
+If an app exceeds these limits, the method continues returning the previous status until the applicable time window passes.
+
 ## -examples
 
 ## -see-also
diff --git a/windows.services.store/storecontext_requestpurchaseasync_1017170817.md b/windows.services.store/storecontext_requestpurchaseasync_1017170817.md
@@ -15,6 +15,9 @@ Requests the purchase for the specified app or add-on and displays the UI that i
 > [!IMPORTANT]
 > This method must be called on the UI thread.
 
+> [!IMPORTANT]
+> In-app purchase functionality is not supported in evelated applications.
+
 ## -parameters
 ### -param storeId
 The Store ID of the app or the add-on that you want to purchase for the current user.
diff --git a/windows.services.store/storecontext_requestpurchaseasync_1039951085.md b/windows.services.store/storecontext_requestpurchaseasync_1039951085.md
@@ -15,6 +15,9 @@ Requests the purchase for the specified app or add-on and displays the UI that i
 > [!IMPORTANT]
 > This method must be called on the UI thread.
 
+> [!IMPORTANT]
+> In-app purchase functionality is not supported in evelated applications.
+
 ## -parameters
 ### -param storeId
 The Store ID of the app or the add-on that you want to purchase for the current user.
diff --git a/windows.services.store/storecontext_requestrateandreviewappasync_2001521545.md b/windows.services.store/storecontext_requestrateandreviewappasync_2001521545.md
@@ -16,6 +16,9 @@ Requests the user to rate and review the app. This method will display the UI fo
 > [!IMPORTANT]
 > This method must be called on the UI thread.
 
+> [!IMPORTANT]
+> In-app rate and review functionality is not supported in evelated applications.
+
 ## -returns
 An asynchronous operation that, on successful completion, returns a [StoreRateAndReviewResult](storerateandreviewresult.md) object that provides status and error info.
 
diff --git a/windows.services.store/storeproduct_requestpurchaseasync_1696674465.md b/windows.services.store/storeproduct_requestpurchaseasync_1696674465.md
@@ -15,6 +15,9 @@ Requests the purchase of the default SKU and availability for the product and di
 > [!IMPORTANT]
 > This method must be called on the UI thread.
 
+> [!IMPORTANT]
+> In-app purchase functionality is not supported in evelated applications.
+
 ## -returns
 An asynchronous operation that, on successful completion, returns a [StorePurchaseResult](storepurchaseresult.md) object that provides status and error info about the purchase.
 
diff --git a/windows.services.store/storeproduct_requestpurchaseasync_1703896342.md b/windows.services.store/storeproduct_requestpurchaseasync_1703896342.md
@@ -15,6 +15,9 @@ Requests the purchase of the default SKU and availability for the product and di
 > [!IMPORTANT]
 > This method must be called on the UI thread.
 
+> [!IMPORTANT]
+> In-app purchase functionality is not supported in evelated applications.
+
 ## -parameters
 ### -param storePurchaseProperties
 An object that specifies additional info for the purchase request, including the product name to display to the user during the purchase.
diff --git a/windows.services.store/storesku_requestpurchaseasync_1696674465.md b/windows.services.store/storesku_requestpurchaseasync_1696674465.md
@@ -15,6 +15,9 @@ Requests the purchase of the product SKU and displays the UI that is used to com
 > [!IMPORTANT]
 > This method must be called on the UI thread.
 
+> [!IMPORTANT]
+> In-app purchase functionality is not supported in evelated applications.
+
 ## -returns
 An asynchronous operation that, on successful completion, returns a [StorePurchaseResult](storepurchaseresult.md) object that provides status and error info about the purchase.
 
diff --git a/windows.services.store/storesku_requestpurchaseasync_1703896342.md b/windows.services.store/storesku_requestpurchaseasync_1703896342.md
@@ -15,6 +15,9 @@ Requests the purchase of the product SKU and displays the UI that is used to com
 > [!IMPORTANT]
 > This method must be called on the UI thread.
 
+> [!IMPORTANT]
+> In-app purchase functionality is not supported in evelated applications.
+
 ## -parameters
 ### -param storePurchaseProperties
 An object that specifies additional info for the purchase request, including the product name to display to the user during the purchase.
diff --git a/windows.services.store/windows_services_store.md b/windows.services.store/windows_services_store.md
@@ -8,6 +8,9 @@
 ## -description
 Provides types and members you can use to access and manage Microsoft Store-related data for the current app. For example, you can use this namespace to get Microsoft Store listing and license info for the current app, purchase the current app or products that are offered by the app, or download and install package updates for the app.
 
+> [!IMPORTANT]
+> In-app purchase and in-app rate and review functionalities are not currently supported in elevated applications.
+
 > [!NOTE]
 > This namespace was introduced in Windows 10, version 1607, and it can only be used in projects that target **Windows 10 Anniversary Edition (10.0; Build 14393)** or a later release in Visual Studio. If your project targets an earlier version of Windows 10, you must use the [Windows.ApplicationModel.Store](../windows.applicationmodel.store/windows_applicationmodel_store.md) namespace instead of the Windows.Services.Store namespace. For more information, see [In-app purchases and trials](/windows/uwp/monetize/in-app-purchases-and-trials).
 
