Improved HINSTANCE-related docs of …etWindowLong…() and CreateWindow…()

sdk-api-src/content/winuser/nf-winuser-createwindowa.md

@@ -126,7 +126,6 @@ The height, in device units, of the window. For overlapped windows, <i>nHeight</
 Type: <b>HWND</b>
 
 A handle to the parent or owner window of the window being created. To create a child window or an owned window, supply a valid window handle. This parameter is optional for pop-up windows.
-
 
 To create a <a href="/windows/desktop/winmsg/window-features">message-only window</a>, supply <b>HWND_MESSAGE</b> or a handle to an existing message-only window.
 
@@ -140,7 +139,7 @@ A handle to a menu, or specifies a child-window identifier depending on the wind
 
 Type: <b>HINSTANCE</b>
 
-A handle to the instance of the module to be associated with the window.
+A handle to the module instance to be associated with the window. This parameter can be either the module instance that registered the class or <b>NULL</b>, and is used in combination with the <i>lpClassName</i> parameter to determine the class of the window to be created. For classes with the <b><a href="/windows/desktop/winmsg/window-class-styles">CS_GLOBALCLASS</a></b> style, like <a href="/windows/desktop/winmsg/about-window-classes#system-classes">system classes</a>, the instance handle is ignored.
 
 ### -param lpParam [in, optional]
 
@@ -150,7 +149,6 @@ A pointer to a value to be passed to the window through the <a href="/windows/de
 
 If an application calls <b>CreateWindow</b> to create a MDI client window, <i>lpParam</i> should point to a <a href="/windows/desktop/api/winuser/ns-winuser-clientcreatestruct">CLIENTCREATESTRUCT</a> structure. If an MDI client window calls <b>CreateWindow</b> to create an MDI child window, <i>lpParam</i> should point to a <a href="/windows/desktop/api/winuser/ns-winuser-mdicreatestructa">MDICREATESTRUCT</a> structure. <i>lpParam</i> may be <b>NULL</b> if no additional data is needed.
 
-
 ## -returns
 
 Type: <b>HWND</b>

sdk-api-src/content/winuser/nf-winuser-createwindowexa.md

@@ -132,7 +132,7 @@ Type: <b>HWND</b>
 
 A handle to the parent or owner window of the window being created. To create a child window or an owned window, supply a valid window handle. This parameter is optional for pop-up windows.
 
- To create a <a href="/windows/desktop/winmsg/window-features">message-only window</a>, supply <b>HWND_MESSAGE</b> or a handle to an existing message-only window.
+To create a <a href="/windows/desktop/winmsg/window-features">message-only window</a>, supply <b>HWND_MESSAGE</b> or a handle to an existing message-only window.
 
 ### -param hMenu [in, optional]
 
@@ -144,7 +144,7 @@ A handle to a menu, or specifies a child-window identifier, depending on the win
 
 Type: <b>HINSTANCE</b>
 
-A handle to the instance of the module to be associated with the window.
+A handle to the module instance to be associated with the window. This parameter can be either the module instance that registered the class or <b>NULL</b>, and is used in combination with the <i>lpClassName</i> parameter to determine the class of the window to be created. For classes with the <b><a href="/windows/desktop/winmsg/window-class-styles">CS_GLOBALCLASS</a></b> style, like <a href="/windows/desktop/winmsg/about-window-classes#system-classes">system classes</a>, the instance handle is ignored.
 
 ### -param lpParam [in, optional]
 

sdk-api-src/content/winuser/nf-winuser-createwindowexw.md

@@ -133,7 +133,7 @@ Type: <b>HWND</b>
 
 A handle to the parent or owner window of the window being created. To create a child window or an owned window, supply a valid window handle. This parameter is optional for pop-up windows.
 
- To create a <a href="/windows/desktop/winmsg/window-features">message-only window</a>, supply <b>HWND_MESSAGE</b> or a handle to an existing message-only window.
+To create a <a href="/windows/desktop/winmsg/window-features">message-only window</a>, supply <b>HWND_MESSAGE</b> or a handle to an existing message-only window.
 
 ### -param hMenu [in, optional]
 
@@ -145,7 +145,7 @@ A handle to a menu, or specifies a child-window identifier, depending on the win
 
 Type: <b>HINSTANCE</b>
 
-A handle to the instance of the module to be associated with the window.
+A handle to the module instance to be associated with the window. This parameter can be either the module instance that registered the class or <b>NULL</b>, and is used in combination with the <i>lpClassName</i> parameter to determine the class of the window to be created. For classes with the <b><a href="/windows/desktop/winmsg/window-class-styles">CS_GLOBALCLASS</a></b> style, like <a href="/windows/desktop/winmsg/about-window-classes#system-classes">system classes</a>, the instance handle is ignored.
 
 ### -param lpParam [in, optional]
 

sdk-api-src/content/winuser/nf-winuser-createwindoww.md

@@ -126,7 +126,6 @@ The height, in device units, of the window. For overlapped windows, <i>nHeight</
 Type: <b>HWND</b>
 
 A handle to the parent or owner window of the window being created. To create a child window or an owned window, supply a valid window handle. This parameter is optional for pop-up windows.
-
 
 To create a <a href="/windows/desktop/winmsg/window-features">message-only window</a>, supply <b>HWND_MESSAGE</b> or a handle to an existing message-only window.
 
@@ -140,7 +139,7 @@ A handle to a menu, or specifies a child-window identifier depending on the wind
 
 Type: <b>HINSTANCE</b>
 
-A handle to the instance of the module to be associated with the window.
+A handle to the module instance to be associated with the window. This parameter can be either the module instance that registered the class or <b>NULL</b>, and is used in combination with the <i>lpClassName</i> parameter to determine the class of the window to be created. For classes with the <b><a href="/windows/desktop/winmsg/window-class-styles">CS_GLOBALCLASS</a></b> style, like <a href="/windows/desktop/winmsg/about-window-classes#system-classes">system classes</a>, the instance handle is ignored.
 
 ### -param lpParam [in, optional]
 

sdk-api-src/content/winuser/nf-winuser-getwindowlonga.md

@@ -104,7 +104,7 @@ Retrieves the <a href="/windows/desktop/winmsg/extended-window-styles">extended
 </dl>
 </td>
 <td width="60%">
-Retrieves a handle to the application instance.
+Retrieves a handle to the module instance associated with the window at creation time, which may have been <b>NULL</b>.
 
 </td>
 </tr>

sdk-api-src/content/winuser/nf-winuser-getwindowlongptra.md

@@ -103,7 +103,7 @@ Retrieves the <a href="/windows/desktop/winmsg/extended-window-styles">extended
 </dl>
 </td>
 <td width="60%">
-Retrieves a handle to the application instance.
+Retrieves a handle to the module instance associated with the window at creation time, which may have been <b>NULL</b>.
 
 </td>
 </tr>

sdk-api-src/content/winuser/nf-winuser-getwindowlongptrw.md

@@ -103,7 +103,7 @@ Retrieves the <a href="/windows/desktop/winmsg/extended-window-styles">extended
 </dl>
 </td>
 <td width="60%">
-Retrieves a handle to the application instance.
+Retrieves a handle to the module instance associated with the window at creation time, which may have been <b>NULL</b>.
 
 </td>
 </tr>

sdk-api-src/content/winuser/nf-winuser-getwindowlongw.md

@@ -104,7 +104,7 @@ Retrieves the <a href="/windows/desktop/winmsg/extended-window-styles">extended
 </dl>
 </td>
 <td width="60%">
-Retrieves a handle to the application instance.
+Retrieves a handle to the module instance associated with the window at creation time, which may have been <b>NULL</b>.
 
 </td>
 </tr>

sdk-api-src/content/winuser/nf-winuser-setclasslonga.md

@@ -141,7 +141,7 @@ Replaces a handle to the icon associated with the class.
 </dl>
 </td>
 <td width="60%">
-Replace a handle to the small icon associated with the class.
+Replaces a handle to the small icon associated with the class.
 
 </td>
 </tr>

sdk-api-src/content/winuser/nf-winuser-setclasslongptra.md

@@ -139,7 +139,7 @@ Replaces a handle to the icon associated with the class.
 </dl>
 </td>
 <td width="60%">
-Retrieves a handle to the small icon associated with the class.
+Replaces a handle to the small icon associated with the class.
 
 </td>
 </tr>

sdk-api-src/content/winuser/nf-winuser-setclasslongptrw.md

@@ -139,7 +139,7 @@ Replaces a handle to the icon associated with the class.
 </dl>
 </td>
 <td width="60%">
-Retrieves a handle to the small icon associated with the class.
+Replaces a handle to the small icon associated with the class.
 
 </td>
 </tr>

sdk-api-src/content/winuser/nf-winuser-setclasslongw.md

@@ -141,7 +141,7 @@ Replaces a handle to the icon associated with the class.
 </dl>
 </td>
 <td width="60%">
-Replace a handle to the small icon associated with the class.
+Replaces a handle to the small icon associated with the class.
 
 </td>
 </tr>

sdk-api-src/content/winuser/nf-winuser-setwindowlonga.md

@@ -103,7 +103,7 @@ Sets a new <a href="/windows/desktop/winmsg/extended-window-styles">extended win
 </dl>
 </td>
 <td width="60%">
-Sets a new application instance handle.
+Sets a new handle to a module instance associated with the window.
 
 </td>
 </tr>

sdk-api-src/content/winuser/nf-winuser-setwindowlongptra.md

@@ -105,7 +105,7 @@ Sets a new <a href="/windows/desktop/winmsg/extended-window-styles">extended win
 </dl>
 </td>
 <td width="60%">
-Sets a new application instance handle.
+Sets a new handle to a module instance associated with the window.
 
 </td>
 </tr>

sdk-api-src/content/winuser/nf-winuser-setwindowlongptrw.md

@@ -105,7 +105,7 @@ Sets a new <a href="/windows/desktop/winmsg/extended-window-styles">extended win
 </dl>
 </td>
 <td width="60%">
-Sets a new application instance handle.
+Sets a new handle to a module instance associated with the window.
 
 </td>
 </tr>

sdk-api-src/content/winuser/nf-winuser-setwindowlongw.md

@@ -103,7 +103,7 @@ Sets a new <a href="/windows/desktop/winmsg/extended-window-styles">extended win
 </dl>
 </td>
 <td width="60%">
-Sets a new application instance handle.
+Sets a new handle to a module instance associated with the window.
 
 </td>
 </tr>

sdk-api-src/content/winuser/ns-winuser-createstructa.md

@@ -186,11 +186,11 @@ PMYDLGDATA pMyDlgdata = (PMYDLGDATA) (((LPCREATESTRUCT) lParam)->lpCreateParams)
 
 
 
-<a href="/windows/desktop/api/winuser/ns-winuser-mdicreatestructa">MDICREATESTRUCT</a>
+<b>Reference</b>
 
 
 
-<b>Reference</b>
+<a href="/windows/desktop/winmsg/wm-create">WM_CREATE</a>
 
 
 

sdk-api-src/content/winuser/ns-winuser-createstructw.md

@@ -186,11 +186,11 @@ PMYDLGDATA pMyDlgdata = (PMYDLGDATA) (((LPCREATESTRUCT) lParam)->lpCreateParams)
 
 
 
-<a href="/windows/desktop/api/winuser/ns-winuser-mdicreatestructw">MDICREATESTRUCT</a>
+<b>Reference</b>
 
 
 
-<b>Reference</b>
+<a href="/windows/desktop/winmsg/wm-create">WM_CREATE</a>