From 161cdb24f08778d96fc039fb738dcb6b5de738d3 Mon Sep 17 00:00:00 2001 From: Nikita Leontiev Date: Wed, 13 May 2026 09:00:05 +0300 Subject: [PATCH] Return value description corrected. Incorrect/broken links fixed. --- .../nc-libloaderapi-enumreslangproca.md | 2 +- .../nc-libloaderapi-enumreslangprocw.md | 2 +- .../nc-libloaderapi-enumresnameproca.md | 6 ++--- .../nc-libloaderapi-enumresnameprocw.md | 18 +++++++-------- .../nc-libloaderapi-enumrestypeproca.md | 9 ++++++-- .../nc-libloaderapi-enumrestypeprocw.md | 23 ++++++++----------- ...f-libloaderapi-enumresourcelanguagesexa.md | 10 ++++---- ...f-libloaderapi-enumresourcelanguagesexw.md | 22 +++++++++--------- .../nf-libloaderapi-enumresourcenamesa.md | 10 ++++---- .../nf-libloaderapi-enumresourcenamesexa.md | 7 +++--- .../nf-libloaderapi-enumresourcenamesexw.md | 22 +++++++++--------- .../nf-libloaderapi-enumresourcenamesw.md | 8 +++---- .../nf-libloaderapi-enumresourcetypesexa.md | 4 ++-- .../nf-libloaderapi-enumresourcetypesexw.md | 16 ++++++------- .../nf-winbase-enumresourcelanguagesa.md | 12 +++++----- .../nf-winbase-enumresourcelanguagesw.md | 18 +++++++-------- .../winbase/nf-winbase-enumresourcetypesa.md | 12 +++++----- .../winbase/nf-winbase-enumresourcetypesw.md | 10 ++++---- 18 files changed, 104 insertions(+), 107 deletions(-) diff --git a/sdk-api-src/content/libloaderapi/nc-libloaderapi-enumreslangproca.md b/sdk-api-src/content/libloaderapi/nc-libloaderapi-enumreslangproca.md index 0c9165c55ae5..4ba5f5aa6d77 100644 --- a/sdk-api-src/content/libloaderapi/nc-libloaderapi-enumreslangproca.md +++ b/sdk-api-src/content/libloaderapi/nc-libloaderapi-enumreslangproca.md @@ -121,4 +121,4 @@ If the callback function returns **FALSE**, then [**EnumResourceLanguagesA**](.. [**MAKELANGID**](../winnt/nf-winnt-makelangid.md) -[Resources](/windows/win32/menurc/resources) +[Menus and Other Resources](/windows/win32/menurc/resources) diff --git a/sdk-api-src/content/libloaderapi/nc-libloaderapi-enumreslangprocw.md b/sdk-api-src/content/libloaderapi/nc-libloaderapi-enumreslangprocw.md index 1f7b02817ec4..92fe19fd7055 100644 --- a/sdk-api-src/content/libloaderapi/nc-libloaderapi-enumreslangprocw.md +++ b/sdk-api-src/content/libloaderapi/nc-libloaderapi-enumreslangprocw.md @@ -121,4 +121,4 @@ If the callback function returns **FALSE**, then [**EnumResourceLanguagesW**](.. [**MAKELANGID**](../winnt/nf-winnt-makelangid.md) -[Resources](/windows/win32/menurc/resources) +[Menus and Other Resources](/windows/win32/menurc/resources) diff --git a/sdk-api-src/content/libloaderapi/nc-libloaderapi-enumresnameproca.md b/sdk-api-src/content/libloaderapi/nc-libloaderapi-enumresnameproca.md index 5097f1738d75..e609c189d287 100644 --- a/sdk-api-src/content/libloaderapi/nc-libloaderapi-enumresnameproca.md +++ b/sdk-api-src/content/libloaderapi/nc-libloaderapi-enumresnameproca.md @@ -61,13 +61,13 @@ A handle to the module whose executable file contains the resources that are bei ### -param lpType -Type: LPCTSTR +Type: LPCSTR The type of resource for which the name is being enumerated. Alternately, rather than a pointer, this parameter can be MAKEINTRESOURCE(ID), where ID is an integer value representing a predefined resource type. For standard resource types, see Resource Types. For more information, see the Remarks section below. ### -param lpName -Type: LPTSTR +Type: LPSTR The name of a resource of the type being enumerated. Alternately, rather than a pointer, this parameter can be MAKEINTRESOURCE(ID), where ID is the integer identifier of the resource. For more information, see the Remarks section below. @@ -118,4 +118,4 @@ If the callback function returns FALSE, then Resources +Menus and Other Resources diff --git a/sdk-api-src/content/libloaderapi/nc-libloaderapi-enumresnameprocw.md b/sdk-api-src/content/libloaderapi/nc-libloaderapi-enumresnameprocw.md index 959ab6cc856b..f8023e90b94b 100644 --- a/sdk-api-src/content/libloaderapi/nc-libloaderapi-enumresnameprocw.md +++ b/sdk-api-src/content/libloaderapi/nc-libloaderapi-enumresnameprocw.md @@ -49,7 +49,7 @@ api_name: ## -description -An application-defined callback function used with the EnumResourceNames and EnumResourceNamesEx functions. It receives the type and name of a resource. The ENUMRESNAMEPROC type defines a pointer to this callback function. EnumResNameProc is a placeholder for the application-defined function name. +An application-defined callback function used with the EnumResourceNames and EnumResourceNamesEx functions. It receives the type and name of a resource. The ENUMRESNAMEPROC type defines a pointer to this callback function. EnumResNameProc is a placeholder for the application-defined function name. ## -parameters @@ -61,13 +61,13 @@ A handle to the module whose executable file contains the resources that are bei ### -param lpType -Type: LPCTSTR +Type: LPCWSTR The type of resource for which the name is being enumerated. Alternately, rather than a pointer, this parameter can be MAKEINTRESOURCE(ID), where ID is an integer value representing a predefined resource type. For standard resource types, see Resource Types. For more information, see the Remarks section below. ### -param lpName -Type: LPTSTR +Type: LPWSTR The name of a resource of the type being enumerated. Alternately, rather than a pointer, this parameter can be MAKEINTRESOURCE(ID), where ID is the integer identifier of the resource. For more information, see the Remarks section below. @@ -75,7 +75,7 @@ The name of a resource of the type being enumerated. Alternately, rather than a Type: LONG_PTR -An application-defined parameter passed to the EnumResourceNames or EnumResourceNamesEx function. This parameter can be used in error checking. +An application-defined parameter passed to the EnumResourceNames or EnumResourceNamesEx function. This parameter can be used in error checking. ## -returns @@ -89,9 +89,9 @@ If IS_INTRESOURCE Similarly, if IS_INTRESOURCE(lpszName) is TRUE, then lpszName specifies the integer identifier of the given resource. Otherwise, it is a pointer to a null-terminated string. If the first character of the string is a pound sign (#), then the remaining characters represent a decimal number that specifies the integer identifier of the resource. -An application must register this function by passing its address to the EnumResourceNames or EnumResourceNamesEx function. +An application must register this function by passing its address to the EnumResourceNames or EnumResourceNamesEx function. -If the callback function returns FALSE, then EnumResourceNames or EnumResourceNamesEx will stop enumeration and return FALSE. On Windows XP and earlier the value obtained from GetLastError will be ERROR_SUCCESS; starting with Windows Vista, the last error value will be ERROR_RESOURCE_ENUM_USER_STOP. +If the callback function returns FALSE, then EnumResourceNames or EnumResourceNamesEx will stop enumeration and return FALSE. On Windows XP and earlier the value obtained from GetLastError will be ERROR_SUCCESS; starting with Windows Vista, the last error value will be ERROR_RESOURCE_ENUM_USER_STOP. > [!NOTE] > The libloaderapi.h header defines ENUMRESNAMEPROC as an alias that automatically selects the ANSI or Unicode version of this function based on the definition of the UNICODE preprocessor constant. Mixing usage of the encoding-neutral alias with code that is not encoding-neutral can lead to mismatches that result in compilation or runtime errors. For more information, see [Conventions for Function Prototypes](/windows/win32/intl/conventions-for-function-prototypes). @@ -102,11 +102,11 @@ If the callback function returns FALSE, then EnumResourceNames +EnumResourceNames -EnumResourceNamesEx +EnumResourceNamesEx @@ -118,4 +118,4 @@ If the callback function returns FALSE, then Resources +Menus and Other Resources diff --git a/sdk-api-src/content/libloaderapi/nc-libloaderapi-enumrestypeproca.md b/sdk-api-src/content/libloaderapi/nc-libloaderapi-enumrestypeproca.md index b8aa653c796d..21dd0209227d 100644 --- a/sdk-api-src/content/libloaderapi/nc-libloaderapi-enumrestypeproca.md +++ b/sdk-api-src/content/libloaderapi/nc-libloaderapi-enumrestypeproca.md @@ -61,7 +61,7 @@ A handle to the module whose executable file contains the resources for which th ### -param lpType -Type: LPTSTR +Type: LPSTR The type of resource for which the type is being enumerated. @@ -94,12 +94,17 @@ If the callback function returns FALSE, then EnumResourceTypes + EnumResourceTypesEx + IS_INTRESOURCE + Reference -Resources + +Menus and Other Resources diff --git a/sdk-api-src/content/libloaderapi/nc-libloaderapi-enumrestypeprocw.md b/sdk-api-src/content/libloaderapi/nc-libloaderapi-enumrestypeprocw.md index 062425b465a6..d7b456dcbe4b 100644 --- a/sdk-api-src/content/libloaderapi/nc-libloaderapi-enumrestypeprocw.md +++ b/sdk-api-src/content/libloaderapi/nc-libloaderapi-enumrestypeprocw.md @@ -49,7 +49,7 @@ api_name: ## -description -An application-defined callback function used with the EnumResourceTypes and EnumResourceTypesEx functions. It receives resource types. The ENUMRESTYPEPROC type defines a pointer to this callback function. EnumResTypeProc is a placeholder for the application-defined function name. +An application-defined callback function used with the EnumResourceTypes and EnumResourceTypesEx functions. It receives resource types. The ENUMRESTYPEPROC type defines a pointer to this callback function. EnumResTypeProc is a placeholder for the application-defined function name. ## -parameters @@ -61,17 +61,17 @@ A handle to the module whose executable file contains the resources for which th ### -param lpType -Type: LPTSTR +Type: LPWSTR The type of resource for which the type is being enumerated. -Alternately, rather than a pointer, this parameter can be MAKEINTRESOURCE(ID), where ID is the integer identifier of the given resource type. For standard resource types, see Resource Types. For more information, see the Remarks section below. +Alternately, rather than a pointer, this parameter can be MAKEINTRESOURCE(ID), where ID is the integer identifier of the given resource type. For standard resource types, see Resource Types. For more information, see the Remarks section below. ### -param lParam [in] Type: LONG_PTR -An application-defined parameter passed to the EnumResourceTypes or EnumResourceTypesEx function. This parameter can be used in error checking. +An application-defined parameter passed to the EnumResourceTypes or EnumResourceTypesEx function. This parameter can be used in error checking. ## -returns @@ -83,9 +83,9 @@ Returns TRUE to continue enumeration or FALSE to stop enumeration. If IS_INTRESOURCE(lpszType) is TRUE, then lpszType specifies the integer identifier of the given resource type. Otherwise, it is a pointer to a null-terminated string. If the first character of the string is a pound sign (#), then the remaining characters represent a decimal number that specifies the integer identifier of the resource type. For example, the string "#258" represents the identifier 258. -An application must register this function by passing its address to the EnumResourceTypes or EnumResourceTypesEx function. +An application must register this function by passing its address to the EnumResourceTypes or EnumResourceTypesEx function. -If the callback function returns FALSE, then EnumResourceTypes or EnumResourceTypesEx will stop enumeration and return FALSE. On Windows XP and earlier the value obtained from GetLastError will be ERROR_SUCCESS; starting with Windows Vista, the last error value will be ERROR_RESOURCE_ENUM_USER_STOP. +If the callback function returns FALSE, then EnumResourceTypes or EnumResourceTypesEx will stop enumeration and return FALSE. On Windows XP and earlier the value obtained from GetLastError will be ERROR_SUCCESS; starting with Windows Vista, the last error value will be ERROR_RESOURCE_ENUM_USER_STOP. > [!NOTE] > The libloaderapi.h header defines ENUMRESTYPEPROC as an alias that automatically selects the ANSI or Unicode version of this function based on the definition of the UNICODE preprocessor constant. Mixing usage of the encoding-neutral alias with code that is not encoding-neutral can lead to mismatches that result in compilation or runtime errors. For more information, see [Conventions for Function Prototypes](/windows/win32/intl/conventions-for-function-prototypes). @@ -95,21 +95,16 @@ If the callback function returns FALSE, then EnumResourceTypes -EnumResourceTypes - - - -EnumResourceTypesEx +EnumResourceTypesEx IS_INTRESOURCE - Reference - -Resources +Menus and Other Resources diff --git a/sdk-api-src/content/libloaderapi/nf-libloaderapi-enumresourcelanguagesexa.md b/sdk-api-src/content/libloaderapi/nf-libloaderapi-enumresourcelanguagesexa.md index bf9f3647c49f..5436385705b1 100644 --- a/sdk-api-src/content/libloaderapi/nf-libloaderapi-enumresourcelanguagesexa.md +++ b/sdk-api-src/content/libloaderapi/nf-libloaderapi-enumresourcelanguagesexa.md @@ -77,7 +77,7 @@ If this parameter is NULL, it is equivalent to passing in a handle to the ### -param lpType [in] -Type: LPCTSTR +Type: LPCSTR The type of the resource for which the language is being enumerated. Alternately, rather than a pointer, this parameter can be MAKEINTRESOURCE(ID), where ID is an integer value representing a predefined resource type. For a list of predefined resource types, see Resource Types. For more @@ -85,7 +85,7 @@ information, see the Remarks section below. ### -param lpName [in] -Type: LPCTSTR +Type: LPCSTR The name of the resource for which the language is being enumerated. Alternately, rather than a pointer, this parameter can be MAKEINTRESOURCE(ID), where ID is the integer identifier of the resource. For more information, see the Remarks section below. @@ -168,7 +168,7 @@ The localization language used to filter the search in the .mui file. This param Type: BOOL -Returns TRUE if the function succeeds or FALSE if the function does not find a resource of the type specified, or if the function fails for another reason. To get extended error information, call GetLastError. +Returns TRUE if the function succeeds or FALSE if the function does not find a resource of the type specified, if the enumeration has been stopped, or if the function fails for another reason. To get extended error information, call GetLastError. ## -remarks @@ -190,7 +190,7 @@ The EnumResourceLanguagesEx function continues to enumerate resource lang If hModule specifies an LN file, and both flags are selected, the languages enumerated include all languages whose resources reside either in the LN file or in any .mui files associated with it. If no .mui files are found, only languages from the LN file are returned. -If dwFlags contains RESOURCE_ENUM_MUI or NULL and LangId is 0, then the enumeration first includes the languages associated with all system-installed .mui files, using languages retrieved from EnumUILanguages.. Finally, if the RESOURCE_ENUM_LN flag is also set, the file designated by hModule is also searched. +If dwFlags contains RESOURCE_ENUM_MUI or NULL and LangId is 0, then the enumeration first includes the languages associated with all system-installed .mui files, using languages retrieved from EnumUILanguages. Finally, if the RESOURCE_ENUM_LN flag is also set, the file designated by hModule is also searched. If the LangId is nonzero, then only the .mui file corresponding to that language identifier will be searched. Language fallbacks will not be used. If an .mui file for that language does not exist, the enumeration will be empty (unless resources for that language exist in the LN file, and the flag is set to search the LN file as well). @@ -234,4 +234,4 @@ For an example, see Resources +Menus and Other Resources diff --git a/sdk-api-src/content/libloaderapi/nf-libloaderapi-enumresourcelanguagesexw.md b/sdk-api-src/content/libloaderapi/nf-libloaderapi-enumresourcelanguagesexw.md index 0d0d565f2dff..38ebef1e6825 100644 --- a/sdk-api-src/content/libloaderapi/nf-libloaderapi-enumresourcelanguagesexw.md +++ b/sdk-api-src/content/libloaderapi/nf-libloaderapi-enumresourcelanguagesexw.md @@ -61,7 +61,7 @@ api_name: ## -description -Enumerates language-specific resources, of the specified type and name, associated with a specified binary module. Extends EnumResourceLanguages by allowing more control over the enumeration. +Enumerates language-specific resources, of the specified type and name, associated with a specified binary module. Extends EnumResourceLanguages by allowing more control over the enumeration. ## -parameters @@ -77,17 +77,17 @@ If this parameter is NULL, it is equivalent to passing in a handle to the ### -param lpType [in] -Type: LPCTSTR +Type: LPCWSTR -The type of the resource for which the language is being enumerated. Alternately, rather than a pointer, this parameter can be MAKEINTRESOURCE(ID), where ID is an integer value representing a predefined resource type. For a list of predefined resource types, see Resource Types. For more +The type of the resource for which the language is being enumerated. Alternately, rather than a pointer, this parameter can be MAKEINTRESOURCE(ID), where ID is an integer value representing a predefined resource type. For a list of predefined resource types, see Resource Types. For more information, see the Remarks section below. ### -param lpName [in] -Type: LPCTSTR +Type: LPCWSTR -The name of the resource for which the language is being enumerated. Alternately, rather than a pointer, this parameter can be MAKEINTRESOURCE(ID), where ID is the integer identifier of the resource. For more information, see the Remarks section below. +The name of the resource for which the language is being enumerated. Alternately, rather than a pointer, this parameter can be MAKEINTRESOURCE(ID), where ID is the integer identifier of the resource. For more information, see the Remarks section below. ### -param lpEnumFunc [in] @@ -168,7 +168,7 @@ The localization language used to filter the search in the .mui file. This param Type: BOOL -Returns TRUE if the function succeeds or FALSE if the function does not find a resource of the type specified, or if the function fails for another reason. To get extended error information, call GetLastError. +Returns TRUE if the function succeeds or FALSE if the function does not find a resource of the type specified, if the enumeration has been stopped, or if the function fails for another reason. To get extended error information, call GetLastError. ## -remarks @@ -190,7 +190,7 @@ The EnumResourceLanguagesEx function continues to enumerate resource lang If hModule specifies an LN file, and both flags are selected, the languages enumerated include all languages whose resources reside either in the LN file or in any .mui files associated with it. If no .mui files are found, only languages from the LN file are returned. -If dwFlags contains RESOURCE_ENUM_MUI or NULL and LangId is 0, then the enumeration first includes the languages associated with all system-installed .mui files, using languages retrieved from EnumUILanguages.. Finally, if the RESOURCE_ENUM_LN flag is also set, the file designated by hModule is also searched. +If dwFlags contains RESOURCE_ENUM_MUI or NULL and LangId is 0, then the enumeration first includes the languages associated with all system-installed .mui files, using languages retrieved from EnumUILanguages. Finally, if the RESOURCE_ENUM_LN flag is also set, the file designated by hModule is also searched. If the LangId is nonzero, then only the .mui file corresponding to that language identifier will be searched. Language fallbacks will not be used. If an .mui file for that language does not exist, the enumeration will be empty (unless resources for that language exist in the LN file, and the flag is set to search the LN file as well). @@ -218,15 +218,15 @@ For an example, see EnumResourceNamesEx +EnumResourceNamesEx -EnumResourceTypesEx +EnumResourceTypesEx -MAKEINTRESOURCE +MAKEINTRESOURCE @@ -234,4 +234,4 @@ For an example, see Resources +Menus and Other Resources diff --git a/sdk-api-src/content/libloaderapi/nf-libloaderapi-enumresourcenamesa.md b/sdk-api-src/content/libloaderapi/nf-libloaderapi-enumresourcenamesa.md index 9644bffdaf90..69e31b45ea39 100644 --- a/sdk-api-src/content/libloaderapi/nf-libloaderapi-enumresourcenamesa.md +++ b/sdk-api-src/content/libloaderapi/nf-libloaderapi-enumresourcenamesa.md @@ -62,7 +62,7 @@ If this parameter is **NULL**, that is equivalent to passing in a handle to the ### -param lpType [in] -Type: **LPCTSTR** +Type: **LPCSTR** The type of the resource for which the name is being enumerated. Alternately, rather than a pointer, this parameter can be [MAKEINTRESOURCE](/windows/desktop/api/winuser/nf-winuser-makeintresourcea)(ID), where ID is an integer value representing a predefined resource type. For a list of predefined resource types, see [Resource Types](/windows/win32/menurc/resource-types). For more information, see the [Remarks](#remarks) section below. @@ -82,7 +82,7 @@ An application-defined value passed to the callback function. This parameter can Type: **BOOL** -The return value is **TRUE** if the function succeeds or **FALSE** if the function does not find a resource of the type specified, or if the function fails for another reason. To get extended error information, call [GetLastError](/windows/desktop/api/errhandlingapi/nf-errhandlingapi-getlasterror). +The return value is **TRUE** if the function succeeds or **FALSE** if the function does not find a resource of the type specified, if the enumeration has been stopped, or if the function fails for another reason. To get extended error information, call [GetLastError](/windows/desktop/api/errhandlingapi/nf-errhandlingapi-getlasterror). ## -remarks @@ -90,7 +90,7 @@ If [IS_INTRESOURCE](/windows/desktop/api/winuser/nf-winuser-is_intresource)(*lps For each resource found, **EnumResourceNames** calls an application-defined callback function *lpEnumFunc*, passing the name or the ID of each resource it finds, as well as the various other parameters that were passed to **EnumResourceNames**. The passed name is only valid inside the callback - if the passed name is a string pointer, it points to an internal buffer that is reused for all callback invocations. -Alternately, applications can call [EnumResourceNamesEx](/windows/desktop/api/libloaderapi/nf-libloaderapi-enumresourcenamesexw), which provides more precise control of what resources are enumerated. +Alternately, applications can call [EnumResourceNamesEx](/windows/desktop/api/libloaderapi/nf-libloaderapi-enumresourcenamesexa), which provides more precise control of what resources are enumerated. If a resource has an ID, the ID is passed to the callback function; otherwise the resource name is passed to the callback function. For more information, see [ENUMRESNAMEPROC](/windows/win32/api/libloaderapi/nc-libloaderapi-enumresnameproca). @@ -100,7 +100,7 @@ Starting with Windows Vista, if *hModule* specifies an LN file, then the resour The enumeration never includes duplicates: if resources with the same name are contained in both the LN file and in an .mui file, the resource will only be enumerated once. -#### Examples +### Examples For an example, see [Creating a Resource List](/windows/desktop/menurc/using-resources#creating-a-resource-list). @@ -110,7 +110,7 @@ For an example, see [Creating a Resource List](/windows/desktop/menurc/using-res - [ENUMRESNAMEPROC](/windows/win32/api/libloaderapi/nc-libloaderapi-enumresnameproca) - [EnumResourceLanguages](/windows/desktop/api/winbase/nf-winbase-enumresourcelanguagesa) -- [EnumResourceNamesEx](/windows/desktop/api/libloaderapi/nf-libloaderapi-enumresourcenamesexw) +- [EnumResourceNamesEx](/windows/desktop/api/libloaderapi/nf-libloaderapi-enumresourcenamesexa) - [EnumResourceTypes](/windows/desktop/api/winbase/nf-winbase-enumresourcetypesa) ### Reference diff --git a/sdk-api-src/content/libloaderapi/nf-libloaderapi-enumresourcenamesexa.md b/sdk-api-src/content/libloaderapi/nf-libloaderapi-enumresourcenamesexa.md index a6223b62239e..a7979ec136d0 100644 --- a/sdk-api-src/content/libloaderapi/nf-libloaderapi-enumresourcenamesexa.md +++ b/sdk-api-src/content/libloaderapi/nf-libloaderapi-enumresourcenamesexa.md @@ -74,7 +74,7 @@ If this parameter is NULL, it is equivalent to passing in a handle to the Type: LPCSTR -The type of the resource for which the name is being enumerated. Alternately, rather than a pointer, this parameter can be MAKEINTRESOURCE(ID), where ID is an integer value representing a predefined resource type. For a list of predefined resource types, see Resource Types. For more information, see the Remarks section below. +The type of the resource for which the name is being enumerated. Alternately, rather than a pointer, this parameter can be MAKEINTRESOURCE(ID), where ID is an integer value representing a predefined resource type. For a list of predefined resource types, see Resource Types. For more information, see the Remarks section below. ### -param lpEnumFunc [in] @@ -144,7 +144,7 @@ The localization language used to filter the search in the MUI module. This para Type: BOOL -The function TRUE if successful, or FALSE if the function does not find a resource of the type specified, or if the function fails for another reason. To get extended error information, call GetLastError. +The function TRUE if successful, or FALSE if the function does not find a resource of the type specified, if the enumeration has been stopped, or if the function fails for another reason. To get extended error information, call GetLastError. ## -remarks @@ -168,7 +168,6 @@ If LangId is nonzero, then only the .mui file corresponding to that Langu The enumeration never includes duplicates: if resources for a particular language are contained in both the LN file and in an .mui file, the name will only be enumerated once. - ## Examples For an example, see Creating a Resource List. @@ -202,4 +201,4 @@ For an example, see Resources +Menus and Other Resources diff --git a/sdk-api-src/content/libloaderapi/nf-libloaderapi-enumresourcenamesexw.md b/sdk-api-src/content/libloaderapi/nf-libloaderapi-enumresourcenamesexw.md index 36276ffa8ca7..4b72db3d8beb 100644 --- a/sdk-api-src/content/libloaderapi/nf-libloaderapi-enumresourcenamesexw.md +++ b/sdk-api-src/content/libloaderapi/nf-libloaderapi-enumresourcenamesexw.md @@ -72,15 +72,15 @@ If this parameter is NULL, it is equivalent to passing in a handle to the ### -param lpType -Type: LPCTSTR +Type: LPCWSTR -The type of the resource for which the name is being enumerated. Alternately, rather than a pointer, this parameter can be MAKEINTRESOURCE(ID), where ID is an integer value representing a predefined resource type. For a list of predefined resource types, see Resource Types. For more information, see the Remarks section below. +The type of the resource for which the name is being enumerated. Alternately, rather than a pointer, this parameter can be MAKEINTRESOURCE(ID), where ID is an integer value representing a predefined resource type. For a list of predefined resource types, see Resource Types. For more information, see the Remarks section below. ### -param lpEnumFunc [in] Type: ENUMRESNAMEPROC -A pointer to the callback function to be called for each enumerated resource name. For more information, see EnumResNameProc. +A pointer to the callback function to be called for each enumerated resource name. For more information, see EnumResNameProc. ### -param lParam [in] @@ -144,7 +144,7 @@ The localization language used to filter the search in the MUI module. This para Type: BOOL -The function TRUE if successful, or FALSE if the function does not find a resource of the type specified, or if the function fails for another reason. To get extended error information, call GetLastError. +The function TRUE if successful, or FALSE if the function does not find a resource of the type specified, if the enumeration has been stopped, or if the function fails for another reason. To get extended error information, call GetLastError. ## -remarks @@ -156,13 +156,13 @@ The enumeration search can include both an LN file and its associated .mui files For each resource found, EnumResourceNamesEx calls an application-defined callback function lpEnumFunc, passing the name or the ID of each resource it finds, as well as the various other parameters that were passed to EnumResourceNamesEx. The passed name is only valid inside the callback - if the passed name is a string pointer, it points to an internal buffer that is reused for all callback invocations. -If a resource has an ID, the ID is returned to the callback function; otherwise the resource name is returned to the callback function. For more information, see EnumResNameProc. +If a resource has an ID, the ID is returned to the callback function; otherwise the resource name is returned to the callback function. For more information, see EnumResNameProc. The EnumResourceNamesEx function continues to enumerate resource names until the callback function returns FALSE or all resource names for this type have been enumerated. If hModule specifies an LN file, and both flags are selected, the names enumerated correspond to resources residing either in that LN file or the .mui files associated with it. If no .mui files are found, only names from the LN file are returned. After one appropriate .mui file is found the search will not continue further, because all .mui files corresponding to a single LN file have the same resource names. -If dwFlags and LangId are both zero, then the function behaves like EnumResourceNames. +If dwFlags and LangId are both zero, then the function behaves like EnumResourceNames. If LangId is nonzero, then only the .mui file corresponding to that Language identifier will be searched. Language fallbacks will not be used. If an .mui file for that language does not exist, the enumeration will be empty (unless resources for that language exist in the LN file, and the flag is set to search the LN file as well). @@ -181,19 +181,19 @@ For an example, see EnumResNameProc +EnumResNameProc -EnumResourceLanguagesEx +EnumResourceLanguagesEx -EnumResourceNames +EnumResourceNames -EnumResourceTypesEx +EnumResourceTypesEx @@ -201,4 +201,4 @@ For an example, see Resources +Menus and Other Resources diff --git a/sdk-api-src/content/libloaderapi/nf-libloaderapi-enumresourcenamesw.md b/sdk-api-src/content/libloaderapi/nf-libloaderapi-enumresourcenamesw.md index f0dd7cb5ddf0..7a209bc8e1ea 100644 --- a/sdk-api-src/content/libloaderapi/nf-libloaderapi-enumresourcenamesw.md +++ b/sdk-api-src/content/libloaderapi/nf-libloaderapi-enumresourcenamesw.md @@ -45,8 +45,6 @@ dev_langs: - c++ --- -# EnumResourceNamesW function - ## -description Enumerates resources of a specified type within a binary module. For Windows Vista and later, this is typically a [language-neutral Portable Executable](/windows/desktop/Intl/mui-resource-management) (LN file), and the enumeration will also include resources from the corresponding language-specific resource files (.mui files) that contain localizable language resources. It is also possible for *hModule* to specify an .mui file, in which case only that file is searched for resources. @@ -63,9 +61,9 @@ If this parameter is **NULL**, that is equivalent to passing in a handle to the ### -param lpType [in] -Type: **LPCTSTR** +Type: **LPCWSTR** -The type of the resource for which the name is being enumerated. Alternately, rather than a pointer, this parameter can be [MAKEINTRESOURCE](/windows/desktop/api/winuser/nf-winuser-makeintresourcea)(ID), where ID is an integer value representing a predefined resource type. For a list of predefined resource types, see [Resource Types](/windows/win32/menurc/resource-types). For more information, see the [Remarks](#remarks) section below. +The type of the resource for which the name is being enumerated. Alternately, rather than a pointer, this parameter can be [MAKEINTRESOURCE](/windows/desktop/api/winuser/nf-winuser-makeintresourcew)(ID), where ID is an integer value representing a predefined resource type. For a list of predefined resource types, see [Resource Types](/windows/win32/menurc/resource-types). For more information, see the [Remarks](#remarks) section below. ### -param lpEnumFunc [in] @@ -83,7 +81,7 @@ An application-defined value passed to the callback function. This parameter can Type: **BOOL** -The return value is **TRUE** if the function succeeds or **FALSE** if the function does not find a resource of the type specified, or if the function fails for another reason. To get extended error information, call [GetLastError](/windows/desktop/api/errhandlingapi/nf-errhandlingapi-getlasterror). +The return value is **TRUE** if the function succeeds or **FALSE** if the function does not find a resource of the type specified, if the enumeration has been stopped, or if the function fails for another reason. To get extended error information, call [GetLastError](/windows/desktop/api/errhandlingapi/nf-errhandlingapi-getlasterror). ## -remarks diff --git a/sdk-api-src/content/libloaderapi/nf-libloaderapi-enumresourcetypesexa.md b/sdk-api-src/content/libloaderapi/nf-libloaderapi-enumresourcetypesexa.md index 1064c1377899..0121084b7044 100644 --- a/sdk-api-src/content/libloaderapi/nf-libloaderapi-enumresourcetypesexa.md +++ b/sdk-api-src/content/libloaderapi/nf-libloaderapi-enumresourcetypesexa.md @@ -145,7 +145,7 @@ The language used to filter the search in the MUI module. This parameter is used Type: BOOL -Returns TRUE if successful or FALSE if the function does not find a resource of the type specified, or if the function fails for another reason. To get extended error information, call GetLastError. +Returns TRUE if successful or FALSE if the function does not find a resource, if the enumeration has been stopped, or if the function fails for another reason. To get extended error information, call GetLastError. ## -remarks @@ -198,4 +198,4 @@ For an example, see Resources +Menus and Other Resources diff --git a/sdk-api-src/content/libloaderapi/nf-libloaderapi-enumresourcetypesexw.md b/sdk-api-src/content/libloaderapi/nf-libloaderapi-enumresourcetypesexw.md index c69570ae83ea..721ba937f49e 100644 --- a/sdk-api-src/content/libloaderapi/nf-libloaderapi-enumresourcetypesexw.md +++ b/sdk-api-src/content/libloaderapi/nf-libloaderapi-enumresourcetypesexw.md @@ -81,7 +81,7 @@ If this parameter is NULL, it is equivalent to passing in a handle to the Type: ENUMRESTYPEPROC -A pointer to the callback function to be called for each enumerated resource type. For more information, see EnumResTypeProc. +A pointer to the callback function to be called for each enumerated resource type. For more information, see EnumResTypeProc. ### -param lParam [in] @@ -145,7 +145,7 @@ The language used to filter the search in the MUI module. This parameter is used Type: BOOL -Returns TRUE if successful or FALSE if the function does not find a resource of the type specified, or if the function fails for another reason. To get extended error information, call GetLastError. +Returns TRUE if successful or FALSE if the function does not find a resource, if the enumeration has been stopped, or if the function fails for another reason. To get extended error information, call GetLastError. ## -remarks @@ -153,7 +153,7 @@ The EnumResourceTypesEx function continues to enumerate resource types un If hModule specifies an LN file, and both flags are selected, the types enumerated correspond to resources residing either in the LN file or in the .mui files associated with it. If no .mui files are found, only types from the LN file are returned. Once one appropriate .mui file is found the search will not continue further, because all .mui files corresponding to a single LN file have the same resource types. -If dwFlags and LangId are both zero, then the function behaves like EnumResourceTypes. +If dwFlags and LangId are both zero, then the function behaves like EnumResourceTypes. If LangId is nonzero, then only the .mui file corresponding to that language identifier will be searched. Language fallbacks will not be used. If an .mui file for that language does not exist, the enumeration will be empty (unless resources for that language exist in the LN file, and the flag is set to search the LN file as well). @@ -178,19 +178,19 @@ For an example, see EnumResTypeProc +EnumResTypeProc -EnumResourceLanguagesEx +EnumResourceLanguagesEx -EnumResourceNamesEx +EnumResourceNamesEx -EnumResourceTypes +EnumResourceTypes @@ -198,4 +198,4 @@ For an example, see Resources +Menus and Other Resources diff --git a/sdk-api-src/content/winbase/nf-winbase-enumresourcelanguagesa.md b/sdk-api-src/content/winbase/nf-winbase-enumresourcelanguagesa.md index 984d25da8717..c7b79c9dd386 100644 --- a/sdk-api-src/content/winbase/nf-winbase-enumresourcelanguagesa.md +++ b/sdk-api-src/content/winbase/nf-winbase-enumresourcelanguagesa.md @@ -68,13 +68,13 @@ If this parameter is NULL, that is equivalent to passing in a handle to t ### -param lpType [in] -Type: LPCTSTR +Type: LPCSTR The type of resource for which the language is being enumerated. Alternately, rather than a pointer, this parameter can be MAKEINTRESOURCE(ID), where ID is an integer value representing a predefined resource type. For a list of predefined resource types, see Resource Types. For more information, see the Remarks section below. ### -param lpName [in] -Type: LPCTSTR +Type: LPCSTR The name of the resource for which the language is being enumerated. Alternately, rather than a pointer, this parameter can be MAKEINTRESOURCE(ID), where ID is the integer identifier of the resource. For more information, see the Remarks section below. @@ -94,7 +94,7 @@ An application-defined value passed to the callback function. This parameter can Type: BOOL -Returns TRUE if successful or FALSE otherwise. To get extended error information, call GetLastError. +Returns TRUE if the function succeeds or FALSE if the function does not find a resource of the type specified, if the enumeration has been stopped, or if the function fails for another reason. To get extended error information, call GetLastError. ## -remarks @@ -106,7 +106,7 @@ Starting with Windows Vista, the binary module is typically a Language Identifiers) of the language for which a resource was found, as well as the various other parameters that were passed to EnumResourceLanguages. -Alternately, applications can call EnumResourceLanguagesEx, which provides more precise control of what resources are enumerated. +Alternately, applications can call EnumResourceLanguagesEx, which provides more precise control of what resources are enumerated. The EnumResourceLanguages function continues to enumerate resource languages until the callback function returns FALSE or all resource languages have been enumerated. @@ -137,7 +137,7 @@ For an example, see Creating a -EnumResourceLanguagesEx +EnumResourceLanguagesEx @@ -153,4 +153,4 @@ For an example, see Creating a -Resources +Menus and Other Resources diff --git a/sdk-api-src/content/winbase/nf-winbase-enumresourcelanguagesw.md b/sdk-api-src/content/winbase/nf-winbase-enumresourcelanguagesw.md index da88e2504f27..8364fb08959a 100644 --- a/sdk-api-src/content/winbase/nf-winbase-enumresourcelanguagesw.md +++ b/sdk-api-src/content/winbase/nf-winbase-enumresourcelanguagesw.md @@ -68,15 +68,15 @@ If this parameter is NULL, that is equivalent to passing in a handle to t ### -param lpType [in] -Type: LPCTSTR +Type: LPCWSTR -The type of resource for which the language is being enumerated. Alternately, rather than a pointer, this parameter can be MAKEINTRESOURCE(ID), where ID is an integer value representing a predefined resource type. For a list of predefined resource types, see Resource Types. For more information, see the Remarks section below. +The type of resource for which the language is being enumerated. Alternately, rather than a pointer, this parameter can be MAKEINTRESOURCE(ID), where ID is an integer value representing a predefined resource type. For a list of predefined resource types, see Resource Types. For more information, see the Remarks section below. ### -param lpName [in] -Type: LPCTSTR +Type: LPCWSTR -The name of the resource for which the language is being enumerated. Alternately, rather than a pointer, this parameter can be MAKEINTRESOURCE(ID), where ID is the integer identifier of the resource. For more information, see the Remarks section below. +The name of the resource for which the language is being enumerated. Alternately, rather than a pointer, this parameter can be MAKEINTRESOURCE(ID), where ID is the integer identifier of the resource. For more information, see the Remarks section below. ### -param lpEnumFunc [in] @@ -94,7 +94,7 @@ An application-defined value passed to the callback function. This parameter can Type: BOOL -Returns TRUE if successful or FALSE otherwise. To get extended error information, call GetLastError. +Returns TRUE if the function succeeds or FALSE if the function does not find a resource of the type specified, if the enumeration has been stopped, or if the function fails for another reason. To get extended error information, call GetLastError. ## -remarks @@ -110,7 +110,7 @@ Alternately, applications can call EnumResourceNames and EnumResourceTypes, this search will look at multiple .mui files. The enumeration begins with .mui files in the folders associated with EnumUILanguages. These are followed by any other .mui files whose paths conform to the scheme described at MUI Resource Management. Finally, the file designated by hModule is also searched. +In Windows Vista and later, if hModule specifies an LN file, then the resources enumerated can reside either in the LN file or in an .mui file associated with it. If no .mui files are found, only resources from the LN file are returned. Unlike EnumResourceNames and EnumResourceTypes, this search will look at multiple .mui files. The enumeration begins with .mui files in the folders associated with EnumUILanguages. These are followed by any other .mui files whose paths conform to the scheme described at MUI Resource Management. Finally, the file designated by hModule is also searched. The enumeration never includes duplicates: if a resource with the same name, type, and language is contained in both the LN file and in an .mui file, the resource will only be enumerated once. @@ -141,11 +141,11 @@ For an example, see Creating a -EnumResourceNames +EnumResourceNames -EnumResourceTypes +EnumResourceTypes @@ -153,4 +153,4 @@ For an example, see Creating a -Resources +Menus and Other Resources diff --git a/sdk-api-src/content/winbase/nf-winbase-enumresourcetypesa.md b/sdk-api-src/content/winbase/nf-winbase-enumresourcetypesa.md index 7ebda40763b1..2f59e5ab5987 100644 --- a/sdk-api-src/content/winbase/nf-winbase-enumresourcetypesa.md +++ b/sdk-api-src/content/winbase/nf-winbase-enumresourcetypesa.md @@ -54,7 +54,7 @@ api_name: Enumerates resource types within a binary module. Starting with Windows Vista, this is typically a language-neutral Portable Executable (LN file), and the enumeration also includes resources from one of the corresponding language-specific resource files (.mui files)—if one exists—that contain localizable language resources. It is also possible to use hModule to specify a .mui file, in which case only that file is searched for resource types. -Alternately, applications can call EnumResourceTypesEx, which provides more precise control over which resource files to enumerate. +Alternately, applications can call EnumResourceTypesEx, which provides more precise control over which resource files to enumerate. ## -parameters @@ -72,7 +72,7 @@ If this parameter is NULL, that is equivalent to passing in a handle to t Type: ENUMRESTYPEPROC -A pointer to the callback function to be called for each enumerated resource type. For more information, see the EnumResTypeProc function. +A pointer to the callback function to be called for each enumerated resource type. For more information, see the EnumResTypeProc function. ### -param lParam [in] @@ -84,7 +84,7 @@ An application-defined value passed to the callback function. Type: BOOL -Returns TRUE if successful; otherwise, FALSE. To get extended error information, call GetLastError. +Returns TRUE if successful or FALSE if the function does not find a resource, if the enumeration has been stopped, or if the function fails for another reason. To get extended error information, call GetLastError. ## -remarks @@ -115,7 +115,7 @@ For an example, see Creating a -EnumResTypeProc +EnumResTypeProc @@ -127,7 +127,7 @@ For an example, see Creating a -EnumResourceTypesEx +EnumResourceTypesEx @@ -135,4 +135,4 @@ For an example, see Creating a -Resources +Menus and Other Resources diff --git a/sdk-api-src/content/winbase/nf-winbase-enumresourcetypesw.md b/sdk-api-src/content/winbase/nf-winbase-enumresourcetypesw.md index 86600bc0650f..d9dbee803215 100644 --- a/sdk-api-src/content/winbase/nf-winbase-enumresourcetypesw.md +++ b/sdk-api-src/content/winbase/nf-winbase-enumresourcetypesw.md @@ -62,7 +62,7 @@ Alternately, applications can call LoadLibrary or LoadLibraryEx. +A handle to a module to be searched. This handle must be obtained through LoadLibrary or LoadLibraryEx. See Remarks for more information. @@ -84,7 +84,7 @@ An application-defined value passed to the callback function. Type: BOOL -Returns TRUE if successful; otherwise, FALSE. To get extended error information, call GetLastError. +Returns TRUE if successful or FALSE if the function does not find a resource, if the enumeration has been stopped, or if the function fails for another reason. To get extended error information, call GetLastError. ## -remarks @@ -119,11 +119,11 @@ For an example, see Creating a -EnumResourceLanguages +EnumResourceLanguages -EnumResourceNames +EnumResourceNames @@ -135,4 +135,4 @@ For an example, see Creating a -Resources +Menus and Other Resources