repo sync public>private

Author: jwmsft

windows.networking.connectivity/connectioncost_roaming.md

@@ -17,6 +17,7 @@ Returns `true` when the connection is roaming on a network outside the home prov
 
 ## -remarks
 
+
 ## -examples
 
 ## -see-also

windows.networking.connectivity/connectionprofile_isdomainauthenticatedby_590452087.md

@@ -58,6 +58,8 @@ behavior.
 
 
 ## -see-also
+[DomainAuthenticationKind](domainauthenticationkind.md)  
+[ConnectionProfile](connectionprofile.md)
 
 [ConnectionProfile](connectionprofile.md),
 [DomainAuthenticationKind](domainauthenticationkind.md)

windows.networking.connectivity/connectivityinterval_starttime.md

@@ -27,6 +27,9 @@ window's start; the returned duration will be truncated accordingly.
 > [!TIP]
 > When stitching results from overlapping queries, de-duplicate intervals by `StartTime`.
 
+> [!TIP]  
+> When stitching results from overlapping queries, de‑duplicate intervals by **StartTime**.
+
 ## -examples
 Enumerate recent interval start times (C#):
 

windows.networking.connectivity/dataplanstatus.md

@@ -56,6 +56,42 @@ If `DataPlanStatus` is null or critical fields are missing:
 > to sensible minimums before applying heuristics.
 
 
+### Null handling
+> [!IMPORTANT]  
+> Always null‑check the returned **DataPlanStatus**. Some profiles (for example unmanaged Wi‑Fi hotspots) do not expose
+> plan information and return null.
+
+### Core elements
+| Property | Meaning / Guidance |
+| -- | -- |
+| [DataPlanUsage](dataplanusage.md) | Current measured usage (may lag real traffic) |
+| DataLimitInMegabytes | Plan cap (nullable). Null => unspecified limit (do not assume unlimited) |
+| MaxTransferSizeInMegabytes | Recommended maximum size for a single transfer (chunk large sync into segments) |
+| NextBillingCycle | Start of next cycle (nullable). Do not assume calendar month boundaries |
+
+### Quota logic guidelines
+- Interpret **DataPlanUsage** together with **DataLimitInMegabytes**. A missing limit means you cannot enforce a hard cap safely.
+- Use both percentage consumed and time remaining before throttling; early-cycle high usage does not always justify restriction.
+- Treat missing **DataLimitInMegabytes** as "unspecified" rather than "unlimited".
+
+### Transfer optimization
+- Honor **MaxTransferSizeInMegabytes** by batching work into chunks at or below the recommendation.
+- For background sync on metered or limited plans, schedule incremental commits instead of monolithic uploads.
+
+### Billing cycle handling
+- **NextBillingCycle** may be absent; fall back to rolling usage display without reset logic.
+- When present, derive remaining quota window precisely; operators define custom cycle boundaries.
+
+### Fallback behavior
+If **DataPlanStatus** is null or critical fields are missing:
+- Present generic usage UI without enforcement.
+- Allow user override for "treat as metered" or "treat as unrestricted" preferences if your app supports it.
+
+> [!NOTE]  
+> Defensive coding: Providers can report unexpected values (like zero or very small **MaxTransferSizeInMegabytes**). Clamp
+> to sensible minimums before applying heuristics.
+
+
 ## -examples
 ### Example (C#):
 

windows.networking.connectivity/domainauthenticationkind.md

@@ -24,7 +24,7 @@ Specifies the domain authentication method for an Active Directory network; and/
 
 ### -field Tls: 2
 
-Specifies the Transport Layer Security (TLS) domain authentication method; and/or that the network connection was able to successfully complete a HTTPS connection with verified TLS authentication to an endpoint configured by the `AllowedTlsAuthenticationEndpoints` Mobile Device Management (MDM) policy.
+Specifies the Transport Layer Security (TLS) domain authentication method; and/or that the network connection was able to successfully complete a HTTPS connection with verified TLS authentication to an endpoint configured by the **AllowedTlsAuthenticationEndpoints** Mobile Device Management (MDM) policy.
 
 ## -remarks
 ### Semantics

windows.networking.connectivity/networkcosttype.md

@@ -100,6 +100,50 @@ if (cost.Roaming)
 }
 ```
 
+// Base operating mode
+if (unrestricted && !cost.Roaming && !cost.BackgroundDataUsageRestricted)
+{
+   // App-specific: enable high-bandwidth features (e.g., HD media sync)
+}
+else
+{
+   // App-specific: enter conservative mode (reduced quality / deferred background work)
+}
+
+// Progressive constraints
+if (cost.ApproachingDataLimit)
+{
+   // App-specific: reduce bitrate / quality to stay within plan (e.g., target ~1.5 Mbps)
+}
+
+if (cost.OverDataLimit)
+{
+   // App-specific: pause non-essential background synchronization
+}
+
+if (cost.BackgroundDataUsageRestricted)
+{
+   // App-specific: defer background-only telemetry / analytics
+}
+
+if (cost.Roaming)
+{
+   // App-specific: compress or batch large payload transfers while roaming
+}
+
+// Optional: adapt chunk sizing based on plan type
+{
+   // Evaluate only when needed for this decision branch.
+   bool fixedPlan = cost.NetworkCostType == NetworkCostType.Fixed;
+   bool variable  = cost.NetworkCostType == NetworkCostType.Variable;
+   if (fixedPlan || variable)
+   {
+      var chunkSizeMb = cost.MaxTransferSizeInMegabytes ?? 8; // choose smaller transfer chunks
+      // App-specific: apply chunkSizeMb constraint to large uploads/downloads
+   }
+}
+```
+
 ## -see-also
 
 [DataPlanStatus](dataplanstatus.md),

windows.web.http/httpresponsemessage.md

@@ -13,7 +13,7 @@ public class HttpResponseMessage : Windows.Foundation.IClosable, Windows.Foundat
 Represents an HTTP response message including headers, the status code, and data.
 
 ## -remarks
-A common way to get an HttpResponseMessage is the from the return value for one of the [DeleteAsync](httpclient_deleteasync_820543917.md), [GetAsync](httpclient_getasync_1105627628.md), [PostAsync](httpclient_postasync_1466488101.md) , [PutAsync](httpclient_putasync_552115331.md), or [SendRequestAsync](httpclient_sendrequestasync_234300504.md) methods on the [HttpClient](httpclient.md) object.
+A common way to get an HttpResponseMessage is from the return value of one of the [DeleteAsync](httpclient_deleteasync_820543917.md), [GetAsync](httpclient_getasync_1105627628.md), [PostAsync](httpclient_postasync_1466488101.md) , [PutAsync](httpclient_putasync_552115331.md), or [SendRequestAsync](httpclient_sendrequestasync_234300504.md) methods on the [HttpClient](httpclient.md) object.
 
 ## -examples