PickIconDlg function (shlobj_core.h)
[PickIconDlg is available for use in the operating systems specified in the Requirements section. It may be altered or unavailable in subsequent versions.]
Displays a dialog box that allows the user to choose an icon from the selection available embedded in a resource such as an executable or DLL file.
int PickIconDlg( [in, optional] HWND hwnd, [in, out] PWSTR pszIconPath, UINT cchIconPath, [in, out, optional] int *piIconIndex );
[in, optional] hwnd
The handle of the parent window. This value can be NULL.
[in, out] pszIconPath
A pointer to a string that contains the null-terminated, fully qualified path of the default resource that contains the icons. If the user chooses a different resource in the dialog, this buffer contains the path of that file when the function returns. This buffer should be at least MAX_PATH characters in length, or the returned path may be truncated. You should verify that the path is valid before using it.
The number of characters in pszIconPath, including the terminating NULL character.
[in, out, optional] piIconIndex
A pointer to an integer that on entry specifies the index of the initial selection and, when this function returns successfully, receives the index of the icon that was selected.
Returns 1 if successful; otherwise, 0.
|Minimum supported client||Windows XP [desktop apps only]|
|Minimum supported server||Windows Server 2003 [desktop apps only]|
|Header||shlobj_core.h (include Shlobj.h)|
|DLL||Shell32.dll (version 6.0 or later)|
|API set||ext-ms-win-shell-shell32-l1-2-1 (introduced in Windows 10, version 10.0.10240)|