Merged PR 17158: fixing several issues with these topics

fixing several issues with these topics
tjs137 · Dec 1, 2020 · 24a1b76 · 24a1b76
1 parent 62f2657
commit 24a1b76
Show file tree

Hide file tree

Showing 5 changed files with 22 additions and 113 deletions.
diff --git a/...t/weakreference/nf-weakreference-iweakreference-resolve(refiid_iinspectable).md b/...t/weakreference/nf-weakreference-iweakreference-resolve(refiid_iinspectable).md
@@ -1,13 +1,12 @@
 ---
 UID: NF:weakreference.IWeakReference.Resolve(REFIID,IInspectable)
 title: IWeakReference::Resolve(REFIID,IInspectable) (weakreference.h)
-description: Resolves a weak reference by returning a strong reference to the specified object.
+description: Resolves a weak reference by returning a strong reference to the object.
 helpviewer_keywords: ["IWeakReference interface [Windows Runtime]","Resolve method","IWeakReference.Resolve","IWeakReference.Resolve(REFIID","IInspectable)","IWeakReference::Resolve","IWeakReference::Resolve(REFIID","IInspectable)","Resolve","Resolve method [Windows Runtime]","Resolve method [Windows Runtime]","IWeakReference interface","weakreference/IWeakReference::Resolve","winrt.iweakreference_resolve"]
 old-location: winrt\iweakreference_resolve.htm
 tech.root: WinRT
 ms.assetid: 642e44f1-7090-4391-b56c-9ba203c30e37
 ms.date: 12/05/2018
-ms.keywords: IWeakReference interface [Windows Runtime],Resolve method, IWeakReference.Resolve, IWeakReference.Resolve(REFIID,IInspectable), IWeakReference::Resolve, IWeakReference::Resolve(REFIID,IInspectable), Resolve, Resolve method [Windows Runtime], Resolve method [Windows Runtime],IWeakReference interface, weakreference/IWeakReference::Resolve, winrt.iweakreference_resolve
 req.header: weakreference.h
 req.include-header: 
 req.target-type: Windows
@@ -45,31 +44,23 @@ api_name:
  - IWeakReference.Resolve
 ---
 
-# IWeakReference::Resolve(REFIID,IInspectable)
-
-
 ## -description
 
-Resolves a weak reference by returning a strong reference to the specified object.
+Resolves a weak reference by returning a strong reference to the object.
 
 ## -parameters
 
 ### -param riid
 
-TBD
-
-### -param objectReference [in]
-
 Type: <b>REFIID</b>
 
-The reference ID of the specified object.
-
+A reference to the interface identifier (IID) of the object.
 
-#### - arg2 [out, retval]
+### -param objectReference
 
-Type: <b><a href="/windows/desktop/api/inspectable/nn-inspectable-iinspectable">IInspectable</a>**</b>
+Type: <b><a href="/windows/win32/api/inspectable/nn-inspectable-iinspectable">IInspectable</a>**</b>
 
-The strong reference to the specified object.
+A strong reference to the object.
 
 ## -returns
 
@@ -79,8 +70,8 @@ If this method succeeds, it returns <b xmlns:loc="http://microsoft.com/wdcml/l10
 
 ## -remarks
 
-If you try to resolve a weak reference to a strong reference for an object that is no longer available, <b>IWeakReference::Resolve</b> returns <b>S_OK</b>, but the <i>objectReference</i> parameter points to null.
+If you try to resolve a weak reference to a strong reference for an object that is no longer available, then <b>IWeakReference::Resolve</b> returns <b>S_OK</b>, but the <i>objectReference</i> parameter points to null.
 
 ## -see-also
 
-<a href="/windows/desktop/api/weakreference/nn-weakreference-iweakreference">IWeakReference</a>
+<a href="/windows/win32/api/weakreference/nn-weakreference-iweakreference">IWeakReference</a>
diff --git a/sdk-api-src/content/weakreference/nf-weakreference-iweakreference-resolve(t_).md b/sdk-api-src/content/weakreference/nf-weakreference-iweakreference-resolve(t_).md
@@ -1,13 +1,12 @@
 ---
 UID: NF:weakreference.IWeakReference.Resolve(T,)
 title: IWeakReference::Resolve(T,) (weakreference.h)
-description: Resolves a weak reference by returning a strong reference to the specified object.
+description: Resolves a weak reference by returning a strong reference to the implementing object.
 helpviewer_keywords: ["IWeakReference interface [Windows Runtime]","Resolve method","IWeakReference.Resolve","IWeakReference.Resolve(T",")","IWeakReference::Resolve","IWeakReference::Resolve(T",")","Resolve","Resolve method [Windows Runtime]","Resolve method [Windows Runtime]","IWeakReference interface","weakreference/IWeakReference::Resolve","winrt.iweakreference_resolve"]
 old-location: winrt\iweakreference_resolve.htm
 tech.root: WinRT
 ms.assetid: 642e44f1-7090-4391-b56c-9ba203c30e37
 ms.date: 12/05/2018
-ms.keywords: IWeakReference interface [Windows Runtime],Resolve method, IWeakReference.Resolve, IWeakReference.Resolve(T,), IWeakReference::Resolve, IWeakReference::Resolve(T,), Resolve, Resolve method [Windows Runtime], Resolve method [Windows Runtime],IWeakReference interface, weakreference/IWeakReference::Resolve, winrt.iweakreference_resolve
 f1_keywords:
 - weakreference/IWeakReference.Resolve
 dev_langs:
@@ -44,60 +43,28 @@ req.redist:
 ms.custom: 19H1
 ---
 
-# IWeakReference::Resolve(T,)
-
-
 ## -description
 
-
-Resolves a weak reference by returning a strong reference to the specified object.
-
+Resolves a weak reference by returning a strong reference to the implementing object.
 
 ## -parameters
 
+### -param objectReference
 
+Type: <b><a href="/windows/win32/api/inspectable/nn-inspectable-iinspectable">IInspectable</a>**</b>
 
-
-### -param objectReference [in]
-
-Type: <b>REFIID</b>
-
-The reference ID of the specified object.
-
-
-#### - arg2 [out, retval]
-
-Type: <b><a href="/windows/desktop/api/inspectable/nn-inspectable-iinspectable">IInspectable</a>**</b>
-
-The strong reference to the specified object.
-
+A strong reference to the object.
 
 ## -returns
 
-
-
 Type: <b>HRESULT</b>
 
 If this method succeeds, it returns <b xmlns:loc="http://microsoft.com/wdcml/l10n">S_OK</b>. Otherwise, it returns an <b xmlns:loc="http://microsoft.com/wdcml/l10n">HRESULT</b> error code.
 
-
-
-
 ## -remarks
 
-
-
-If you try to resolve a weak reference to a strong reference for an object that is no longer available, <b>IWeakReference::Resolve</b> returns <b>S_OK</b>, but the <i>objectReference</i> parameter points to null.
-
-
-
+If you try to resolve a weak reference to a strong reference for an object that is no longer available, then <b>IWeakReference::Resolve</b> returns <b>S_OK</b>, but the <i>objectReference</i> parameter points to null.
 
 ## -see-also
 
-
-
-
-<a href="/windows/desktop/api/weakreference/nn-weakreference-iweakreference">IWeakReference</a>
-
-
-
+<a href="/windows/win32/api/weakreference/nn-weakreference-iweakreference">IWeakReference</a>
diff --git a/...content/weakreference/nf-weakreference-iweakreferencesource-getweakreference.md b/...content/weakreference/nf-weakreference-iweakreferencesource-getweakreference.md
@@ -7,7 +7,6 @@ old-location: winrt\iweakreferencesource_getweakreference.htm
 tech.root: WinRT
 ms.assetid: 6856cad0-4571-4951-a917-8d010706f2d5
 ms.date: 12/05/2018
-ms.keywords: GetWeakReference, GetWeakReference method [Windows Runtime], GetWeakReference method [Windows Runtime],IWeakReferenceSource interface, IWeakReferenceSource interface [Windows Runtime],GetWeakReference method, IWeakReferenceSource.GetWeakReference, IWeakReferenceSource::GetWeakReference, weakreference/IWeakReferenceSource::GetWeakReference, winrt.iweakreferencesource_getweakreference
 req.header: weakreference.h
 req.include-header: 
 req.target-type: Windows
@@ -45,27 +44,24 @@ api_name:
  - IWeakReferenceSource.GetWeakReference
 ---
 
-# IWeakReferenceSource::GetWeakReference
-
-
 ## -description
 
-Retrieves a weak reference from an <a href="/windows/desktop/api/weakreference/nn-weakreference-iweakreferencesource">IWeakReferenceSource</a>.
+Retrieves a weak reference from an <a href="/windows/win32/api/weakreference/nn-weakreference-iweakreferencesource">IWeakReferenceSource</a>.
 
 ## -parameters
 
-### -param weakReference [out, retval]
+### -param weakReference
 
-Type: <b><a href="/windows/desktop/api/weakreference/nn-weakreference-iweakreference">IWeakReference</a>**</b>
+Type: [out, retval] <b><a href="/windows/win32/api/weakreference/nn-weakreference-iweakreference">IWeakReference</a>**</b>
 
 The weak reference.
 
 ## -returns
 
 Type: <b>HRESULT</b>
 
-If this method succeeds, it returns <b xmlns:loc="http://microsoft.com/wdcml/l10n">S_OK</b>. Otherwise, it returns an <b xmlns:loc="http://microsoft.com/wdcml/l10n">HRESULT</b> error code.
+If this method succeeds, then it returns <b xmlns:loc="http://microsoft.com/wdcml/l10n">S_OK</b>. Otherwise, it returns an <b xmlns:loc="http://microsoft.com/wdcml/l10n">HRESULT</b> error code.
 
 ## -see-also
 
-<a href="/windows/desktop/api/weakreference/nn-weakreference-iweakreferencesource">IWeakReferenceSource</a>
+<a href="/windows/win32/api/weakreference/nn-weakreference-iweakreferencesource">IWeakReferenceSource</a>
diff --git a/sdk-api-src/content/weakreference/nn-weakreference-iweakreference.md b/sdk-api-src/content/weakreference/nn-weakreference-iweakreference.md
@@ -45,32 +45,10 @@ api_name:
  - IWeakReference
 ---
 
-# IWeakReference interface
-
-
 ## -description
 
 Represents a weak reference to an object.
 
 ## -inheritance
 
-The <b xmlns:loc="http://microsoft.com/wdcml/l10n">IWeakReference</b> interface inherits from the <a href="/windows/desktop/api/unknwn/nn-unknwn-iunknown">IUnknown</a> interface. 
-
-## -members
-
-The <b>IWeakReference</b> interface has these methods.
-<table class="members" id="memberListMethods">
-<tr>
-<th align="left" width="37%">Method</th>
-<th align="left" width="63%">Description</th>
-</tr>
-<tr data="declared;">
-<td align="left" width="37%">
-<a href="/windows/desktop/api/weakreference/nf-weakreference-iweakreference-resolve(refiid_iinspectable)">Resolve</a>
-</td>
-<td align="left" width="63%">
-Resolves a weak reference by returning a strong reference to the specified object.
-
-</td>
-</tr>
-</table>
+The <b xmlns:loc="http://microsoft.com/wdcml/l10n">IWeakReference</b> interface inherits from the <a href="/windows/win32/api/unknwn/nn-unknwn-iunknown">IUnknown</a> interface. 
diff --git a/sdk-api-src/content/weakreference/nn-weakreference-iweakreferencesource.md b/sdk-api-src/content/weakreference/nn-weakreference-iweakreferencesource.md
@@ -7,7 +7,6 @@ old-location: winrt\iweakreferencesource.htm
 tech.root: WinRT
 ms.assetid: f4b85374-192b-4024-80c2-a46bfebb16c1
 ms.date: 12/05/2018
-ms.keywords: IWeakReferenceSource, IWeakReferenceSource interface [Windows Runtime], IWeakReferenceSource interface [Windows Runtime],described, weakreference/IWeakReferenceSource, winrt.iweakreferencesource
 req.header: weakreference.h
 req.include-header: 
 req.target-type: Windows
@@ -45,32 +44,10 @@ api_name:
  - IWeakReferenceSource
 ---
 
-# IWeakReferenceSource interface
-
-
 ## -description
 
 Represents a source object to which a weak reference can be retrieved.
 
 ## -inheritance
 
-The <b xmlns:loc="http://microsoft.com/wdcml/l10n">IWeakReferenceSource</b> interface inherits from the <a href="/windows/desktop/api/unknwn/nn-unknwn-iunknown">IUnknown</a> interface.
-
-## -members
-
-The <b>IWeakReferenceSource</b> interface has these methods.
-<table class="members" id="memberListMethods">
-<tr>
-<th align="left" width="37%">Method</th>
-<th align="left" width="63%">Description</th>
-</tr>
-<tr data="declared;">
-<td align="left" width="37%">
-<a href="/windows/desktop/api/weakreference/nf-weakreference-iweakreferencesource-getweakreference">GetWeakReference</a>
-</td>
-<td align="left" width="63%">
-Retrieves a weak reference from an <b>IWeakReferenceSource</b>.
-
-</td>
-</tr>
-</table>
+The <b xmlns:loc="http://microsoft.com/wdcml/l10n">IWeakReferenceSource</b> interface inherits from the <a href="/windows/win32/api/unknwn/nn-unknwn-iunknown">IUnknown</a> interface.