From 870fb3ad2f547b319b27ca7e5a560cddd40b0bba Mon Sep 17 00:00:00 2001 From: Enyium <123484196+Enyium@users.noreply.github.com> Date: Fri, 30 Jan 2026 19:38:54 +0100 Subject: [PATCH 1/5] Changed "See also" list of `CREATESTRUCT`. - Added `WM_CREATE`. - Removed `MDICREATESTRUCT`. Reason: Its companion `CLIENTCREATESTRUCT` also isn't listed under "See also", and both are linked in the text for the `lpCreateParams` parameter. --- sdk-api-src/content/winuser/ns-winuser-createstructa.md | 4 ++-- sdk-api-src/content/winuser/ns-winuser-createstructw.md | 4 ++-- 2 files changed, 4 insertions(+), 4 deletions(-) diff --git a/sdk-api-src/content/winuser/ns-winuser-createstructa.md b/sdk-api-src/content/winuser/ns-winuser-createstructa.md index 88103ffdca57..b36a73ed9cbe 100644 --- a/sdk-api-src/content/winuser/ns-winuser-createstructa.md +++ b/sdk-api-src/content/winuser/ns-winuser-createstructa.md @@ -186,11 +186,11 @@ PMYDLGDATA pMyDlgdata = (PMYDLGDATA) (((LPCREATESTRUCT) lParam)->lpCreateParams) -MDICREATESTRUCT +Reference -Reference +WM_CREATE diff --git a/sdk-api-src/content/winuser/ns-winuser-createstructw.md b/sdk-api-src/content/winuser/ns-winuser-createstructw.md index 1d30f5b00cf3..0c3e1f734cd2 100644 --- a/sdk-api-src/content/winuser/ns-winuser-createstructw.md +++ b/sdk-api-src/content/winuser/ns-winuser-createstructw.md @@ -186,11 +186,11 @@ PMYDLGDATA pMyDlgdata = (PMYDLGDATA) (((LPCREATESTRUCT) lParam)->lpCreateParams) -MDICREATESTRUCT +Reference -Reference +WM_CREATE From bf6b34e2a4d648404f417bf65c6ad76f56042c2f Mon Sep 17 00:00:00 2001 From: Enyium <123484196+Enyium@users.noreply.github.com> Date: Fri, 30 Jan 2026 18:08:52 +0100 Subject: [PATCH 2/5] =?UTF-8?q?Minor=20fixes=20and=20equalization=20for=20?= =?UTF-8?q?`SetClassLong=E2=80=A6()`.?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- sdk-api-src/content/winuser/nf-winuser-setclasslonga.md | 2 +- sdk-api-src/content/winuser/nf-winuser-setclasslongptra.md | 2 +- sdk-api-src/content/winuser/nf-winuser-setclasslongptrw.md | 2 +- sdk-api-src/content/winuser/nf-winuser-setclasslongw.md | 2 +- 4 files changed, 4 insertions(+), 4 deletions(-) diff --git a/sdk-api-src/content/winuser/nf-winuser-setclasslonga.md b/sdk-api-src/content/winuser/nf-winuser-setclasslonga.md index 68f4347e6ca9..0f56e182054e 100644 --- a/sdk-api-src/content/winuser/nf-winuser-setclasslonga.md +++ b/sdk-api-src/content/winuser/nf-winuser-setclasslonga.md @@ -141,7 +141,7 @@ Replaces a handle to the icon associated with the class. -Replace a handle to the small icon associated with the class. +Replaces a handle to the small icon associated with the class. diff --git a/sdk-api-src/content/winuser/nf-winuser-setclasslongptra.md b/sdk-api-src/content/winuser/nf-winuser-setclasslongptra.md index 99a1b15b15fa..45e947cf389b 100644 --- a/sdk-api-src/content/winuser/nf-winuser-setclasslongptra.md +++ b/sdk-api-src/content/winuser/nf-winuser-setclasslongptra.md @@ -139,7 +139,7 @@ Replaces a handle to the icon associated with the class. -Retrieves a handle to the small icon associated with the class. +Replaces a handle to the small icon associated with the class. diff --git a/sdk-api-src/content/winuser/nf-winuser-setclasslongptrw.md b/sdk-api-src/content/winuser/nf-winuser-setclasslongptrw.md index cb6ce72e653a..1c8dfe23311e 100644 --- a/sdk-api-src/content/winuser/nf-winuser-setclasslongptrw.md +++ b/sdk-api-src/content/winuser/nf-winuser-setclasslongptrw.md @@ -139,7 +139,7 @@ Replaces a handle to the icon associated with the class. -Retrieves a handle to the small icon associated with the class. +Replaces a handle to the small icon associated with the class. diff --git a/sdk-api-src/content/winuser/nf-winuser-setclasslongw.md b/sdk-api-src/content/winuser/nf-winuser-setclasslongw.md index a1e4c9e0707b..32311e4de720 100644 --- a/sdk-api-src/content/winuser/nf-winuser-setclasslongw.md +++ b/sdk-api-src/content/winuser/nf-winuser-setclasslongw.md @@ -141,7 +141,7 @@ Replaces a handle to the icon associated with the class. -Replace a handle to the small icon associated with the class. +Replaces a handle to the small icon associated with the class. From cb12f2a1063bfa2b91e78004665a91df87169b35 Mon Sep 17 00:00:00 2001 From: Enyium <123484196+Enyium@users.noreply.github.com> Date: Fri, 30 Jan 2026 19:16:32 +0100 Subject: [PATCH 3/5] =?UTF-8?q?Fixed=20too=20restrictive=20phrasing=20for?= =?UTF-8?q?=20`GWL=E2=80=A6=5FHINSTANCE`.?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Module handles can not only be application modules, but also those for `comdlg32.dll`, `user32.dll` or any other DLL. Phrasing based on docs of `CreateWindowExW()`'s `hInstance` argument. --- sdk-api-src/content/winuser/nf-winuser-getwindowlonga.md | 2 +- sdk-api-src/content/winuser/nf-winuser-getwindowlongptra.md | 2 +- sdk-api-src/content/winuser/nf-winuser-getwindowlongptrw.md | 2 +- sdk-api-src/content/winuser/nf-winuser-getwindowlongw.md | 2 +- sdk-api-src/content/winuser/nf-winuser-setwindowlonga.md | 2 +- sdk-api-src/content/winuser/nf-winuser-setwindowlongptra.md | 2 +- sdk-api-src/content/winuser/nf-winuser-setwindowlongptrw.md | 2 +- sdk-api-src/content/winuser/nf-winuser-setwindowlongw.md | 2 +- 8 files changed, 8 insertions(+), 8 deletions(-) diff --git a/sdk-api-src/content/winuser/nf-winuser-getwindowlonga.md b/sdk-api-src/content/winuser/nf-winuser-getwindowlonga.md index 625899ddd06b..9a23cec234b1 100644 --- a/sdk-api-src/content/winuser/nf-winuser-getwindowlonga.md +++ b/sdk-api-src/content/winuser/nf-winuser-getwindowlonga.md @@ -104,7 +104,7 @@ Retrieves the extended -Retrieves a handle to the application instance. +Retrieves a handle to the module instance associated with the window at creation time. diff --git a/sdk-api-src/content/winuser/nf-winuser-getwindowlongptra.md b/sdk-api-src/content/winuser/nf-winuser-getwindowlongptra.md index 7ff268397403..6862fe264e26 100644 --- a/sdk-api-src/content/winuser/nf-winuser-getwindowlongptra.md +++ b/sdk-api-src/content/winuser/nf-winuser-getwindowlongptra.md @@ -103,7 +103,7 @@ Retrieves the extended -Retrieves a handle to the application instance. +Retrieves a handle to the module instance associated with the window at creation time. diff --git a/sdk-api-src/content/winuser/nf-winuser-getwindowlongptrw.md b/sdk-api-src/content/winuser/nf-winuser-getwindowlongptrw.md index d58c7ad01b42..ceee865883bd 100644 --- a/sdk-api-src/content/winuser/nf-winuser-getwindowlongptrw.md +++ b/sdk-api-src/content/winuser/nf-winuser-getwindowlongptrw.md @@ -103,7 +103,7 @@ Retrieves the extended -Retrieves a handle to the application instance. +Retrieves a handle to the module instance associated with the window at creation time. diff --git a/sdk-api-src/content/winuser/nf-winuser-getwindowlongw.md b/sdk-api-src/content/winuser/nf-winuser-getwindowlongw.md index 65d4d4141567..1b5d9ab61315 100644 --- a/sdk-api-src/content/winuser/nf-winuser-getwindowlongw.md +++ b/sdk-api-src/content/winuser/nf-winuser-getwindowlongw.md @@ -104,7 +104,7 @@ Retrieves the extended -Retrieves a handle to the application instance. +Retrieves a handle to the module instance associated with the window at creation time. diff --git a/sdk-api-src/content/winuser/nf-winuser-setwindowlonga.md b/sdk-api-src/content/winuser/nf-winuser-setwindowlonga.md index 0e07f90c0063..0a843c02c25d 100644 --- a/sdk-api-src/content/winuser/nf-winuser-setwindowlonga.md +++ b/sdk-api-src/content/winuser/nf-winuser-setwindowlonga.md @@ -103,7 +103,7 @@ Sets a new extended win -Sets a new application instance handle. +Sets a new handle to a module instance associated with the window. diff --git a/sdk-api-src/content/winuser/nf-winuser-setwindowlongptra.md b/sdk-api-src/content/winuser/nf-winuser-setwindowlongptra.md index c7ab44d3af03..1c03c467a476 100644 --- a/sdk-api-src/content/winuser/nf-winuser-setwindowlongptra.md +++ b/sdk-api-src/content/winuser/nf-winuser-setwindowlongptra.md @@ -105,7 +105,7 @@ Sets a new extended win -Sets a new application instance handle. +Sets a new handle to a module instance associated with the window. diff --git a/sdk-api-src/content/winuser/nf-winuser-setwindowlongptrw.md b/sdk-api-src/content/winuser/nf-winuser-setwindowlongptrw.md index 87741a523eca..cc3218664c62 100644 --- a/sdk-api-src/content/winuser/nf-winuser-setwindowlongptrw.md +++ b/sdk-api-src/content/winuser/nf-winuser-setwindowlongptrw.md @@ -105,7 +105,7 @@ Sets a new extended win -Sets a new application instance handle. +Sets a new handle to a module instance associated with the window. diff --git a/sdk-api-src/content/winuser/nf-winuser-setwindowlongw.md b/sdk-api-src/content/winuser/nf-winuser-setwindowlongw.md index 202b3856ed19..918b876243ed 100644 --- a/sdk-api-src/content/winuser/nf-winuser-setwindowlongw.md +++ b/sdk-api-src/content/winuser/nf-winuser-setwindowlongw.md @@ -103,7 +103,7 @@ Sets a new extended win -Sets a new application instance handle. +Sets a new handle to a module instance associated with the window. From 43cecf291f94312028ed2b1fded1595ce6afabe9 Mon Sep 17 00:00:00 2001 From: Enyium <123484196+Enyium@users.noreply.github.com> Date: Sat, 31 Jan 2026 01:27:41 +0100 Subject: [PATCH 4/5] =?UTF-8?q?Explain=20`NULL`=20as=20realistic=20value?= =?UTF-8?q?=20of=20`GWL=E2=80=A6=5FHINSTANCE`.?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit This is noteworthy, because many functions translate a module (instance) handle of `NULL` to a concrete handle. --- sdk-api-src/content/winuser/nf-winuser-getwindowlonga.md | 2 +- sdk-api-src/content/winuser/nf-winuser-getwindowlongptra.md | 2 +- sdk-api-src/content/winuser/nf-winuser-getwindowlongptrw.md | 2 +- sdk-api-src/content/winuser/nf-winuser-getwindowlongw.md | 2 +- 4 files changed, 4 insertions(+), 4 deletions(-) diff --git a/sdk-api-src/content/winuser/nf-winuser-getwindowlonga.md b/sdk-api-src/content/winuser/nf-winuser-getwindowlonga.md index 9a23cec234b1..ebe2bb901067 100644 --- a/sdk-api-src/content/winuser/nf-winuser-getwindowlonga.md +++ b/sdk-api-src/content/winuser/nf-winuser-getwindowlonga.md @@ -104,7 +104,7 @@ Retrieves the extended -Retrieves a handle to the module instance associated with the window at creation time. +Retrieves a handle to the module instance associated with the window at creation time, which may have been NULL. diff --git a/sdk-api-src/content/winuser/nf-winuser-getwindowlongptra.md b/sdk-api-src/content/winuser/nf-winuser-getwindowlongptra.md index 6862fe264e26..44aad7601cf5 100644 --- a/sdk-api-src/content/winuser/nf-winuser-getwindowlongptra.md +++ b/sdk-api-src/content/winuser/nf-winuser-getwindowlongptra.md @@ -103,7 +103,7 @@ Retrieves the extended -Retrieves a handle to the module instance associated with the window at creation time. +Retrieves a handle to the module instance associated with the window at creation time, which may have been NULL. diff --git a/sdk-api-src/content/winuser/nf-winuser-getwindowlongptrw.md b/sdk-api-src/content/winuser/nf-winuser-getwindowlongptrw.md index ceee865883bd..8fbee8d70819 100644 --- a/sdk-api-src/content/winuser/nf-winuser-getwindowlongptrw.md +++ b/sdk-api-src/content/winuser/nf-winuser-getwindowlongptrw.md @@ -103,7 +103,7 @@ Retrieves the extended -Retrieves a handle to the module instance associated with the window at creation time. +Retrieves a handle to the module instance associated with the window at creation time, which may have been NULL. diff --git a/sdk-api-src/content/winuser/nf-winuser-getwindowlongw.md b/sdk-api-src/content/winuser/nf-winuser-getwindowlongw.md index 1b5d9ab61315..c1b205ac4c37 100644 --- a/sdk-api-src/content/winuser/nf-winuser-getwindowlongw.md +++ b/sdk-api-src/content/winuser/nf-winuser-getwindowlongw.md @@ -104,7 +104,7 @@ Retrieves the extended -Retrieves a handle to the module instance associated with the window at creation time. +Retrieves a handle to the module instance associated with the window at creation time, which may have been NULL. From 6faecc81af700bac64645ba745c1c4fb296cb197 Mon Sep 17 00:00:00 2001 From: Enyium <123484196+Enyium@users.noreply.github.com> Date: Sat, 31 Jan 2026 01:04:40 +0100 Subject: [PATCH 5/5] =?UTF-8?q?Extended=20docs=20for=20`hInstance`=20param?= =?UTF-8?q?eter=20of=20`CreateWindow=E2=80=A6()`.?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Source: tests and article --- sdk-api-src/content/winuser/nf-winuser-createwindowa.md | 4 +--- sdk-api-src/content/winuser/nf-winuser-createwindowexa.md | 4 ++-- sdk-api-src/content/winuser/nf-winuser-createwindowexw.md | 4 ++-- sdk-api-src/content/winuser/nf-winuser-createwindoww.md | 3 +-- 4 files changed, 6 insertions(+), 9 deletions(-) diff --git a/sdk-api-src/content/winuser/nf-winuser-createwindowa.md b/sdk-api-src/content/winuser/nf-winuser-createwindowa.md index 52cff3a9f766..3688dd7b9519 100644 --- a/sdk-api-src/content/winuser/nf-winuser-createwindowa.md +++ b/sdk-api-src/content/winuser/nf-winuser-createwindowa.md @@ -126,7 +126,6 @@ The height, in device units, of the window. For overlapped windows, nHeightHWND 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 message-only window, supply HWND_MESSAGE 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: HINSTANCE -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 NULL, and is used in combination with the lpClassName parameter to determine the class of the window to be created. For classes with the CS_GLOBALCLASS style, like system classes, 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 CLIENTCREATESTRUCT structure. If an MDI client window calls CreateWindow to create an MDI child window, lpParam should point to a MDICREATESTRUCT structure. lpParam may be NULL if no additional data is needed. - ## -returns Type: HWND diff --git a/sdk-api-src/content/winuser/nf-winuser-createwindowexa.md b/sdk-api-src/content/winuser/nf-winuser-createwindowexa.md index 229f8c3bd52e..a90f62efa297 100644 --- a/sdk-api-src/content/winuser/nf-winuser-createwindowexa.md +++ b/sdk-api-src/content/winuser/nf-winuser-createwindowexa.md @@ -132,7 +132,7 @@ Type: HWND 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 message-only window, supply HWND_MESSAGE or a handle to an existing message-only window. +To create a message-only window, supply HWND_MESSAGE 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: HINSTANCE -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 NULL, and is used in combination with the lpClassName parameter to determine the class of the window to be created. For classes with the CS_GLOBALCLASS style, like system classes, the instance handle is ignored. ### -param lpParam [in, optional] diff --git a/sdk-api-src/content/winuser/nf-winuser-createwindowexw.md b/sdk-api-src/content/winuser/nf-winuser-createwindowexw.md index bb0e889784af..e04318e73d2b 100644 --- a/sdk-api-src/content/winuser/nf-winuser-createwindowexw.md +++ b/sdk-api-src/content/winuser/nf-winuser-createwindowexw.md @@ -133,7 +133,7 @@ Type: HWND 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 message-only window, supply HWND_MESSAGE or a handle to an existing message-only window. +To create a message-only window, supply HWND_MESSAGE 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: HINSTANCE -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 NULL, and is used in combination with the lpClassName parameter to determine the class of the window to be created. For classes with the CS_GLOBALCLASS style, like system classes, the instance handle is ignored. ### -param lpParam [in, optional] diff --git a/sdk-api-src/content/winuser/nf-winuser-createwindoww.md b/sdk-api-src/content/winuser/nf-winuser-createwindoww.md index 18a5c023713c..a7c3a9c5fc04 100644 --- a/sdk-api-src/content/winuser/nf-winuser-createwindoww.md +++ b/sdk-api-src/content/winuser/nf-winuser-createwindoww.md @@ -126,7 +126,6 @@ The height, in device units, of the window. For overlapped windows, nHeightHWND 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 message-only window, supply HWND_MESSAGE 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: HINSTANCE -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 NULL, and is used in combination with the lpClassName parameter to determine the class of the window to be created. For classes with the CS_GLOBALCLASS style, like system classes, the instance handle is ignored. ### -param lpParam [in, optional]