Missing API docs part 4 - SA (#3654)

* missing refs

* XML error

* Apply suggestions from code review

Co-Authored-By: Maira Wenzel <[email protected]>

* source error

* link error

Author: steveada

xml/Microsoft.CLRAdmin/IPropertySheetCallback.xml

@@ -42,9 +42,10 @@
         <Parameter Name="hPage" Type="System.IntPtr" />
       </Parameters>
       <Docs>
-        <param name="hPage">To be added.</param>
-        <summary>This API supports the .NET Framework infrastructure and is not intended to be used directly from your code.</summary>
+        <param name="hPage">The handle to a property sheet page to add to a property sheet.</param>
+        <summary>Adds a page to a property sheet.</summary>
         <remarks>To be added.</remarks>
+        <forInternalUseOnly />
       </Docs>
     </Member>
     <Member MemberName="RemovePage">
@@ -66,9 +67,10 @@
         <Parameter Name="hPage" Type="System.IntPtr" />
       </Parameters>
       <Docs>
-        <param name="hPage">To be added.</param>
-        <summary>This API supports the .NET Framework infrastructure and is not intended to be used directly from your code.</summary>
+        <param name="hPage">The handle to a property sheet page to remove from a property sheet.</param>
+        <summary>Removes a page from a property sheet.</summary>
         <remarks>To be added.</remarks>
+        <forInternalUseOnly />
       </Docs>
     </Member>
   </Members>

xml/Microsoft.CLRAdmin/ISnapinAbout.xml

@@ -42,9 +42,10 @@
         <Parameter Name="pName" Type="System.IntPtr" RefType="out" />
       </Parameters>
       <Docs>
-        <param name="pName">To be added.</param>
-        <summary>This API supports the .NET Framework infrastructure and is not intended to be used directly from your code.</summary>
+        <param name="pName">When this method returns, contains the provider name of the snap-in. This parameter is passed uninitialized.</param>
+        <summary>Obtains the provider name of the snap-in.</summary>
         <remarks>To be added.</remarks>
+        <forInternalUseOnly />
       </Docs>
     </Member>
     <Member MemberName="GetSnapinDescription">
@@ -66,9 +67,10 @@
         <Parameter Name="lpDescription" Type="System.IntPtr" RefType="out" />
       </Parameters>
       <Docs>
-        <param name="lpDescription">To be added.</param>
-        <summary>This API supports the .NET Framework infrastructure and is not intended to be used directly from your code.</summary>
+        <param name="lpDescription">When this method returns, contains the text for the description box on an About property page. This parameter is passed uninitialized.</param>
+        <summary>Allows the console to get the text for the description box on the About property page for the snap-in.</summary>
         <remarks>To be added.</remarks>
+        <forInternalUseOnly />
       </Docs>
     </Member>
     <Member MemberName="GetSnapinImage">
@@ -90,9 +92,10 @@
         <Parameter Name="hAppIcon" Type="System.IntPtr" RefType="out" />
       </Parameters>
       <Docs>
-        <param name="hAppIcon">To be added.</param>
-        <summary>This API supports the .NET Framework infrastructure and is not intended to be used directly from your code.</summary>
+        <param name="hAppIcon">When this method returns, contains the handle to the main icon of the snap-in used by the About property page. This parameter is passed uninitialized.</param>
+        <summary>Allows the console to get the main icon that is used in the About property page for a snap-in.</summary>
         <remarks>To be added.</remarks>
+        <forInternalUseOnly />
       </Docs>
     </Member>
     <Member MemberName="GetSnapinVersion">
@@ -114,9 +117,10 @@
         <Parameter Name="lpVersion" Type="System.IntPtr" RefType="out" />
       </Parameters>
       <Docs>
-        <param name="lpVersion">To be added.</param>
-        <summary>This API supports the .NET Framework infrastructure and is not intended to be used directly from your code.</summary>
+        <param name="lpVersion">When this method returns, contains text specifying the version number for the snap-in. This parameter is passed uninitialized.</param>
+        <summary>Allows the console to get the version number for the snap-in.</summary>
         <remarks>To be added.</remarks>
+        <forInternalUseOnly />
       </Docs>
     </Member>
     <Member MemberName="GetStaticFolderImage">
@@ -141,12 +145,13 @@
         <Parameter Name="cMask" Type="System.Int32" RefType="out" />
       </Parameters>
       <Docs>
-        <param name="hSmallImage">To be added.</param>
-        <param name="hSmallImageOpen">To be added.</param>
-        <param name="hLargeImage">To be added.</param>
-        <param name="cMask">To be added.</param>
-        <summary>This API supports the .NET Framework infrastructure and is not intended to be used directly from your code.</summary>
+        <param name="hSmallImage">When this method returns, contains the handle to a small icon (16 x 16 pixels) in either the scope or results view pane.</param>
+        <param name="hSmallImageOpen">When this method returns, contains the handle to a small open folder icon (16 x 16 pixels).</param>
+        <param name="hLargeImage">When this method returns, contains the handle to a large icon (32 x 32 pixels).</param>
+        <param name="cMask">When this method returns, contains a structure that specifies the color used to generate a mask.</param>
+        <summary>Allows the console to get the static folder images for the scope and results panes.</summary>
         <remarks>To be added.</remarks>
+        <forInternalUseOnly />
       </Docs>
     </Member>
   </Members>

xml/Microsoft.CLRAdmin/MMC_CONTROL_TYPE.xml

@@ -34,7 +34,7 @@
       </ReturnValue>
       <MemberValue>2</MemberValue>
       <Docs>
-        <summary>To be added.</summary>
+        <summary>A combo box control.</summary>
       </Docs>
     </Member>
     <Member MemberName="MENUBUTTON">
@@ -54,7 +54,7 @@
       </ReturnValue>
       <MemberValue>1</MemberValue>
       <Docs>
-        <summary>To be added.</summary>
+        <summary>A drop-down menu control.</summary>
       </Docs>
     </Member>
     <Member MemberName="TOOLBAR">
@@ -74,7 +74,7 @@
       </ReturnValue>
       <MemberValue>0</MemberValue>
       <Docs>
-        <summary>To be added.</summary>
+        <summary>A toolbar control.</summary>
       </Docs>
     </Member>
   </Members>

xml/Microsoft.CLRAdmin/PropSheetPageProc.xml

@@ -21,11 +21,12 @@
     <ReturnType>System.UInt32</ReturnType>
   </ReturnValue>
   <Docs>
-    <param name="hwnd">To be added.</param>
-    <param name="uMsg">To be added.</param>
-    <param name="lParam">To be added.</param>
-    <summary>This API supports the .NET Framework infrastructure and is not intended to be used directly from your code.</summary>
-    <returns>To be added.</returns>
+    <param name="hwnd">Reserved; must be null (Nothing in Visual Basic).</param>
+    <param name="uMsg">An action flag specifying that a page or a dialog box for a page is being created or a page is being destroyed.</param>
+    <param name="lParam">A pointer to a structure defining the page being created or destroyed.</param>
+    <summary>Specifies a callback function that a property sheet calls when a page is created and when the page is about to be destroyed.</summary>
+    <returns>The value of uMsg.</returns>
     <remarks>To be added.</remarks>
+    <forInternalUseOnly />
   </Docs>
 </Type>

xml/Microsoft.JScript.Vsa/VsaEngine.xml

@@ -117,9 +117,9 @@
         <Parameter Name="domain" Type="System.AppDomain" Index="0" FrameworkAlternate="netframework-4.0;netframework-4.5;netframework-4.5.1;netframework-4.5.2;netframework-4.6;netframework-4.6.1;netframework-4.6.2;netframework-4.7;netframework-4.7.1;netframework-4.7.2;netframework-4.8" />
       </Parameters>
       <Docs>
-        <param name="domain">To be added.</param>
-        <summary>This class, member, or property is internal to the script engine and should not be called from your code.</summary>
-        <returns>To be added.</returns>
+        <param name="domain">The application domain in which to create the new engine.</param>
+        <summary>Creates a new identical engine that runs in a new application domain, with the same compiled state and named items. </summary>
+        <returns>The new engine.</returns>
         <remarks>To be added.</remarks>
         <forInternalUseOnly />
       </Docs>
@@ -146,8 +146,9 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>This class, member, or property is internal to the script engine and should not be called from your code.</summary>
-        <returns>To be added.</returns>
+        <summary>Triggers compilation of all the state currently in the engine. All references, code items, host items, and resources are run through the compiler.</summary>
+        <returns>
+        <see langword="true" /> if the compilation was successful; otherwise, <see langword="false" />.</returns>
         <remarks>To be added.</remarks>
         <forInternalUseOnly />
       </Docs>
@@ -551,8 +552,8 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>This class, member, or property is internal to the script engine and should not be called from your code.</summary>
-        <returns>To be added.</returns>
+        <summary>Gets the compiled assembly that is produced by the compilation step.</summary>
+        <returns>The compiled assembly.</returns>
         <remarks>To be added.</remarks>
         <forInternalUseOnly />
       </Docs>
@@ -606,8 +607,8 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>This class, member, or property is internal to the script engine and should not be called from your code.</summary>
-        <returns>To be added.</returns>
+        <summary>Gets the global scope object.</summary>
+        <returns>The global scope object.</returns>
         <remarks>To be added.</remarks>
         <forInternalUseOnly />
       </Docs>
@@ -736,8 +737,8 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>This class, member, or property is internal to the script engine and should not be called from your code.</summary>
-        <returns>To be added.</returns>
+        <summary>Gets the code module from the compiled assembly.</summary>
+        <returns>The code module from the compiled assembly.</returns>
         <remarks>To be added.</remarks>
         <forInternalUseOnly />
       </Docs>
@@ -840,10 +841,11 @@
         <Parameter Name="site" Type="Microsoft.JScript.Vsa.IJSVsaSite" Index="1" FrameworkAlternate="netframework-4.0;netframework-4.5;netframework-4.5.1;netframework-4.5.2;netframework-4.6;netframework-4.6.1;netframework-4.6.2;netframework-4.7;netframework-4.7.1;netframework-4.7.2;netframework-4.8" />
       </Parameters>
       <Docs>
-        <param name="rootMoniker">To be added.</param>
-        <param name="site">To be added.</param>
-        <summary>This class, member, or property is internal to the script engine and should not be called from your code.</summary>
+        <param name="rootMoniker">The root moniker of the script engine.</param>
+        <param name="site">The host-implemented <see cref="T:Microsoft.JScript.Vsa.IJSVsaSite" /> object that is used by the script engine to communicate with the host.</param>
+        <summary>Initializes the <see cref="T:Microsoft.JScript.Vsa.VsaEngine" />.</summary>
         <remarks>To be added.</remarks>
+        <forInternalUseOnly />
       </Docs>
     </Member>
     <Member MemberName="InitVsaEngine">
@@ -870,10 +872,11 @@
         <Parameter Name="site" Type="Microsoft.Vsa.IVsaSite" Index="1" FrameworkAlternate="netframework-1.1;netframework-2.0;netframework-3.0;netframework-3.5" />
       </Parameters>
       <Docs>
-        <param name="rootMoniker">To be added.</param>
-        <param name="site">To be added.</param>
-        <summary>This API supports the .NET Framework infrastructure and is not intended to be used directly from your code.</summary>
+        <param name="rootMoniker">The root moniker of the script engine.</param>
+        <param name="site">The host-implemented <see cref="T:Microsoft.Vsa.IVsaSite" /> object that is used by the script engine to communicate with the host.</param>
+        <summary>Initializes the <see cref="T:Microsoft.JScript.Vsa.VsaEngine" />.</summary>
         <remarks>To be added.</remarks>
+        <forInternalUseOnly />
       </Docs>
     </Member>
     <Member MemberName="Interrupt">
@@ -1080,8 +1083,8 @@
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <param name="name">To be added.</param>
-        <summary>This class, member, or property is internal to the script engine and should not be called from your code.</summary>
+        <param name="name">The name of an added item that provides events.</param>
+        <summary>Specifies the name of an item that is marked as an event source, so that the <see cref="M:Microsoft.JScript.Vsa.VsaEngine.ConnectEvents" /> method can determine which events to connect.</summary>
         <remarks>To be added.</remarks>
         <forInternalUseOnly />
       </Docs>
@@ -1182,9 +1185,10 @@
         <Parameter Name="domain" Type="System.AppDomain" />
       </Parameters>
       <Docs>
-        <param name="domain">To be added.</param>
-        <summary>This class, member, or property is internal to the script engine and should not be called from your code.</summary>
+        <param name="domain">The application domain in which to run the compiled code.</param>
+        <summary>Runs the compiled code in the specified application domain.</summary>
         <remarks>To be added.</remarks>
+        <forInternalUseOnly />
       </Docs>
     </Member>
     <Member MemberName="RunEmpty">