Retrieves information about system-defined Shell icons.
SHSTDAPI SHGetStockIconInfo( SHSTOCKICONID siid, UINT uFlags, SHSTOCKICONINFO *psii );
One of the values from the SHSTOCKICONID enumeration that specifies which icon should be retrieved.
A combination of zero or more of the following flags that specify which information is requested.
The szPath and iIcon members of the SHSTOCKICONINFO structure receive the path and icon index of the requested icon, in a format suitable for passing to the ExtractIcon function. The numerical value of this flag is zero, so you always get the icon location regardless of other flags.
The hIcon member of the SHSTOCKICONINFO structure receives a handle to the specified icon.
The iSysImageImage member of the SHSTOCKICONINFO structure receives the index of the specified icon in the system imagelist.
Modifies the SHGSI_ICON value by causing the function to add the link overlay to the file's icon.
Modifies the SHGSI_ICON value by causing the function to blend the icon with the system highlight color.
Modifies the SHGSI_ICON value by causing the function to retrieve the large version of the icon, as specified by the SM_CXICON and SM_CYICON system metrics.
Modifies the SHGSI_ICON value by causing the function to retrieve the small version of the icon, as specified by the SM_CXSMICON and SM_CYSMICON system metrics.
Modifies the SHGSI_LARGEICON or SHGSI_SMALLICON values by causing the function to retrieve the Shell-sized icons rather than the sizes specified by the system metrics.
A pointer to a SHSTOCKICONINFO structure. When this function is called, the cbSize member of this structure needs to be set to the size of the SHSTOCKICONINFO structure. When this function returns, contains a pointer to a SHSTOCKICONINFO structure that contains the requested information.
If this function succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.
|Minimum supported client||Windows Vista [desktop apps only]|
|Minimum supported server||Windows Server 2008 [desktop apps only]|