IExtractIcon::Extract


		Contents Index Topic Contents
	Previous Topic: IExtractIcon Next Topic: IExtractIcon::GetIconLocation

IExtractIcon::Extract
HRESULT Extract(
    LPCSTR pszFile,
    UINT nIconIndex,
    HICON *phiconLarge,
    HICON *phiconSmall,
    UINT nIconSize
   );		
Extracts an icon image from the specified location.
Returns NOERROR if the function extracted the icon, or S_FALSE if the calling application should extract the icon.

pszFile
Address of a null-terminated string specifying the icon location.
nIconIndex
Icon index.
phiconLarge
Address of the variable that receives the handle to the large icon.
phiconSmall
Address of the variable that receives the handle to the small icon.
nIconSize
Desired size, in pixels, of the icon. The low word contains the size of the large icon, and the high word contains the size of the small icon. The size specified can be the width or height. The width of an icon always equals its height.

The icon location and index are the same values returned by the GetIconLocation method. If this function returns S_FALSE, these values must specify an icon file name and index that form legal parameters for a call to Extract. If Extract does not return S_FALSE, no assumptions should be made about the meanings of the pszFile and nIconIndex parameters.
See also IExtractIcon

Top of Page
© 1997 Microsoft Corporation. All rights reserved. Terms of Use.