Merged PR 20903: New APIs for SmartAppControlPolicy and IPropertyValue

New and updated APIs for SmartAppControlPolicy and IPropertyValue. GetDateTimeArray removed the api with a DateTimeOffset array param and added one with a DateTime array.

Author: alvinashcraft

windows.foundation/ipropertyvalue_getdatetimearray_1161464137.md

@@ -1,23 +1,28 @@
 ---
--api-id: M:Windows.Foundation.IPropertyValue.GetDateTimeArray(Windows.Foundation.DateTimeOffset[]@)
+-api-id: M:Windows.Foundation.IPropertyValue.GetDateTimeArray(Windows.Foundation.DateTime[]@)
 -api-type: winrt method
 ---
 
 <!-- Method syntax
-public void GetDateTimeArray(Windows.Foundation.DateTimeOffset[] value)
+public void GetDateTimeArray (out Windows.Foundation.DateTime[] value);
 -->
 
-# Windows.Foundation.IPropertyValue.GetDateTimeArray
+# Windows.Foundation.IPropertyValue.GetDateTimeArray(Windows.Foundation.DateTime[]@)
 
 ## -description
+
 Returns the array of date and time values stored as a property value.
 
 ## -parameters
+
 ### -param value
+
 The array of values.
 
 ## -remarks
 
-## -examples
-
 ## -see-also
+
+[IPropertyValue](ipropertyvalue.md), [DateTime](datetime.md)
+
+## -examples

windows.system.profile/smartappcontrolpolicy.md

@@ -0,0 +1,80 @@
+---
+-api-id: T:Windows.System.Profile.SmartAppControlPolicy
+-api-type: winrt class
+---
+
+# Windows.System.Profile.SmartAppControlPolicy
+
+<!--
+public static class SmartAppControlPolicy
+-->
+
+## -description
+
+The **Smart App Control** policy interface and runtime class.
+
+## -remarks
+
+**Smart App Control** is a new security feature in Windows 11, which improves consumer PC security by blocking apps that are malicious or untrusted. It is implemented as a Microsoft Defender Application Control (MDAC) policy, similar to [Windows in S mode](https://support.microsoft.com/windows/windows-10-and-windows-11-in-s-mode-faq-851057d6-1ee9-b9e5-c30b-93baebeebc85).
+
+Apps and services may want to query the **Smart App Control** mode on a given system, or register for a notification when the state changes. This can be done with the **SmartAppControlPolicy** APIs.
+
+## -see-also
+
+[What is Smart App Control?](https://support.microsoft.com/topic/what-is-smart-app-control-285ea03d-fa88-4d56-882e-6698afdb7003)
+
+## -examples
+
+The following example shows how to register for the [SmartAppControlPolicy.Changed](smartappcontrolpolicy_changed.md) event and handle the event when it's raised.
+
+```csharp
+using Windows.System.Profile;
+
+public class SmartAppControlPolicySample: IDisposable
+{
+    public SmartAppControlPolicySample()
+    {
+        SmartAppControlPolicy.Changed += OnSmartAppControlPolicyChanged;
+        OnSmartAppControlPolicyChanged();
+    }
+
+    ~SmartAppControlPolicySample()
+    {
+        SmartAppControlPolicy.Changed -= OnSmartAppControlPolicyChanged;
+    }
+
+    public void HandleSmartAppControlPolicyChange()
+    {
+        //
+        // Change related UI Elements
+        //
+        ChangeUIForSmartAppControl(SmartAppControlPolicy.IsEnabled);
+    }
+
+    void OnSmartAppControlPolicyChanged(object args)
+    {
+        //
+        // Smart App Control Policy state changed.
+        //
+        HandleSmartAppControlPolicyChange();
+
+        //
+        // Manage detection settings.
+        //
+        if (!SmartAppControlPolicy.IsEnabled)
+        {
+            //
+            // Set AV in full scanning mode.
+            //
+            SetMalwareDetectionBehavior(MalwareDetectionBehavior.FullDetectionMode);
+        }
+        else
+        {
+            //
+            // Set AV in light weight scanning mode.
+            //
+            SetMalwareDetectionBehavior(MalwareDetectionBehavior.LightweightDetectionMode);
+        }
+    }
+}
+```

windows.system.profile/smartappcontrolpolicy_changed.md

@@ -0,0 +1,22 @@
+---
+-api-id: E:Windows.System.Profile.SmartAppControlPolicy.Changed
+-api-type: winrt event
+---
+
+# Windows.System.Profile.SmartAppControlPolicy.Changed
+
+<!--
+public static event System.EventHandler<object> Changed;
+-->
+
+## -description
+
+This event is invoked when the **Smart App Control** state has changed.
+
+## -remarks
+
+## -see-also
+
+[IsEnabled](smartappcontrolpolicy_isenabled.md)
+
+## -examples

windows.system.profile/smartappcontrolpolicy_isenabled.md

@@ -0,0 +1,24 @@
+---
+-api-id: P:Windows.System.Profile.SmartAppControlPolicy.IsEnabled
+-api-type: winrt property
+---
+
+# Windows.System.Profile.SmartAppControlPolicy.IsEnabled
+
+<!--
+public static bool IsEnabled { get; }
+-->
+
+## -description
+
+Indicates whether **Smart App Control** is enabled.
+
+## -property-value
+
+## -remarks
+
+## -see-also
+
+[Changed](smartappcontrolpolicy_changed.md)
+
+## -examples