Add missing API docs part 11 - SA (#3747)

* add missing items

* add out description

* small edits

* fix broken link

Co-authored-by: Maira Wenzel <[email protected]>

Author: steveada

xml/Microsoft.CLRAdmin/CData.xml

@@ -193,12 +193,18 @@
         <Parameter Name="lpIDataObject" Type="Microsoft.CLRAdmin.IDataObject" />
       </Parameters>
       <Docs>
-        <param name="lpProvider">To be added.</param>
-        <param name="handle">To be added.</param>
-        <param name="lpIDataObject">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="lpProvider">A pointer to the <see cref="T:Microsoft.CLRAdmin.IPropertySheetCallback" />.</param>
+        <param name="handle">The handle to use to route the notification message to the appropriate <see cref="T:Microsoft.CLRAdmin.IComponent" /> or <see cref="T:Microsoft.CLRAdmin.IComponentData" />.</param>
+        <param name="lpIDataObject">A pointer to the <see cref="T:Microsoft.CLRAdmin.IDataObject" /> on the object containing context information about the scope or result item.</param>
+        <summary>Adds pages to a property sheet.</summary>
+        <returns>| Return Value | Description |
+| --- | --- |
+| S\_OK | The <see cref="M:Microsoft.CLRAdmin.CData.CreatePropertyPages(Microsoft.CLRAdmin.IPropertySheetCallback,System.IntPtr,Microsoft.CLRAdmin.IDataObject)" /> method successfully added the property sheet pages. |
+| S\_FALSE | The <see cref="M:Microsoft.CLRAdmin.CData.CreatePropertyPages(Microsoft.CLRAdmin.IPropertySheetCallback,System.IntPtr,Microsoft.CLRAdmin.IDataObject)" /> method added no property sheet pages. |
+| E\_UNEXPECTED | An unexpected error occurred. |
+| E\_INVALIDARG | One or more parameters are not valid. |</returns>
         <remarks>To be added.</remarks>
+        <forInternalUseOnly />
       </Docs>
     </Member>
     <Member MemberName="Destroy">
@@ -278,14 +284,17 @@
         <Parameter Name="bStretch" Type="System.Int32" RefType="out" />
       </Parameters>
       <Docs>
-        <param name="lpIDataObject">To be added.</param>
-        <param name="lphWatermark">To be added.</param>
-        <param name="lphHeader">To be added.</param>
-        <param name="lphPalette">To be added.</param>
-        <param name="bStretch">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="lpIDataObject">The <see cref="T:Microsoft.CLRAdmin.IDataObject" /> on the object containing context information about the scope or result item.</param>
+        <param name="lphWatermark">When this method returns, the handle to a bitmap that serves as the watermark for Wizard 97 pages.</param>
+        <param name="lphHeader">When this method returns, the handle to a bitmap that serves as the header for Wizard 97 pages.</param>
+        <param name="lphPalette">When this method returns, the handle to a palette used for the bitmaps specified by <paramref name="lphWatermark" /> and <paramref name="lphHeader" />.</param>
+        <param name="bStretch">When this method returns, <see langword="true" /> if the watermark and header bitmaps should be stretched rather than tiled; otherwise, <see langword="false" />.</param>
+        <summary>Retrieves the watermark and header bitmaps for wizard sheets that are implemented as Wizard 97-style wizards.</summary>
+        <returns>| Return Value | Description |
+| --- | --- |
+| etch | <see langword="true" /> if the watermark and header bitmaps should be stretched rather than tiled; otherwise, <see langword="false" />. |</returns>
         <remarks>To be added.</remarks>
+        <forInternalUseOnly />
       </Docs>
     </Member>
     <Member MemberName="Initialize">
@@ -402,10 +411,16 @@
         <Parameter Name="lpDataObject" Type="Microsoft.CLRAdmin.IDataObject" />
       </Parameters>
       <Docs>
-        <param name="lpDataObject">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="lpDataObject">A pointer to the <see cref="T:Microsoft.CLRAdmin.IDataObject" /> on the object containing context information about the scope or result item.</param>
+        <summary>Determines whether the object requires pages.</summary>
+        <returns>| Return value | Description |
+| --- | --- |
+| S\_OK | Properties exist for this data object. |
+| E\_UNEXPECTED | An unexpected error occurred. |
+| E\_INVALID | The parameter is not valid. |
+| Any other error code | No pages are supplied for the data object. |</returns>
         <remarks>To be added.</remarks>
+        <forInternalUseOnly />
       </Docs>
     </Member>
   </Members>

xml/Microsoft.JScript.Vsa/VsaEngine.xml

@@ -632,9 +632,9 @@
         <Parameter Name="itemName" Type="System.String" 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="itemName">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="itemName">The name of the item to get.</param>
+        <summary>Gets the item from the scope that is designated by the specified name.</summary>
+        <returns>The item with the specified name.</returns>
         <remarks>To be added.</remarks>
         <forInternalUseOnly />
       </Docs>
@@ -658,9 +658,9 @@
         <Parameter Name="index" Type="System.Int32" 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="index">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="index">The index of the item to get.</param>
+        <summary>Gets the item from the scope that is designated by the specified index value.</summary>
+        <returns>The item at the specified index.</returns>
         <remarks>To be added.</remarks>
         <forInternalUseOnly />
       </Docs>
@@ -684,8 +684,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 number of items in the scope.</summary>
+        <returns>The number of items in the scope.</returns>
         <remarks>To be added.</remarks>
         <forInternalUseOnly />
       </Docs>

xml/Microsoft.VisualBasic.Vsa/VsaCompilerError.xml

@@ -24,7 +24,7 @@
     </Attribute>
   </Attributes>
   <Docs>
-    <summary>To be added.</summary>
+    <summary>Represents a compiler error or warning.</summary>
     <remarks>To be added.</remarks>
   </Docs>
   <Members>
@@ -48,8 +48,8 @@
         <ReturnType>System.String</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added.</summary>
-        <value>To be added.</value>
+        <summary>Gets a brief description of the error.</summary>
+        <value>A string description of the error.</value>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -73,8 +73,8 @@
         <ReturnType>System.Int32</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added.</summary>
-        <value>To be added.</value>
+        <summary>Gets the ending column number for the source text that caused the error, if available.</summary>
+        <value>The ending column number for the source text that caused the error, if available.</value>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -98,8 +98,8 @@
         <ReturnType>System.Int32</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added.</summary>
-        <value>To be added.</value>
+        <summary>Gets the line number on which an error occurs.</summary>
+        <value>The line number on which the error has occurred.</value>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -123,8 +123,8 @@
         <ReturnType>System.String</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added.</summary>
-        <value>To be added.</value>
+        <summary>Gets the text of the source code from the line that caused the error.</summary>
+        <value>The source code from the line that caused the error.</value>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -148,8 +148,8 @@
         <ReturnType>System.Int32</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added.</summary>
-        <value>To be added.</value>
+        <summary>Gets a number that uniquely identifies the error.</summary>
+        <value>The number that uniquely identifies the error.</value>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -173,8 +173,8 @@
         <ReturnType>System.Int32</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added.</summary>
-        <value>To be added.</value>
+        <summary>Gets the severity of the error.</summary>
+        <value>An integer (0-4) that represents the error severity.</value>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -198,8 +198,8 @@
         <ReturnType>Microsoft.Vsa.IVsaItem</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added.</summary>
-        <value>To be added.</value>
+        <summary>Gets a reference to the <see cref="T:Microsoft.Vsa.IVsaItem" /> object that generated the error.</summary>
+        <value>A reference to the object that generated the error.</value>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -223,8 +223,8 @@
         <ReturnType>System.String</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added.</summary>
-        <value>To be added.</value>
+        <summary>Gets the fully qualified name of the source item that contained the error.</summary>
+        <value>The fully qualified name of the source item that contained the error.</value>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -248,8 +248,8 @@
         <ReturnType>System.Int32</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added.</summary>
-        <value>To be added.</value>
+        <summary>Gets the starting column number for the source text that caused the error, if available.</summary>
+        <value>The starting column number for the source text that caused the error, if available.</value>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>