Método IExtractIconA::Extract (shlobj_core.h)

Extrae una imagen de icono de la ubicación especificada.

Sintaxis

HRESULT Extract(
  [in]            PCSTR pszFile,
                  UINT  nIconIndex,
  [out, optional] HICON *phiconLarge,
  [out, optional] HICON *phiconSmall,
                  UINT  nIconSize
);

Parámetros

[in] pszFile

Tipo: PCTSTR

Puntero a una cadena terminada en null que especifica la ubicación del icono.

nIconIndex

Tipo: UINT

Índice del icono del archivo al que apunta pszFile.

[out, optional] phiconLarge

Tipo: HICON*

Puntero a un valor HICON que recibe el identificador del icono grande. Este parámetro puede ser NULL.

[out, optional] phiconSmall

Tipo: HICON*

Puntero a un valor HICON que recibe el identificador al icono pequeño. Este parámetro puede ser NULL.

nIconSize

Tipo: UINT

Tamaño deseado del icono, en píxeles. La palabra baja contiene el tamaño del icono grande y la palabra alta contiene el tamaño del icono pequeño. El tamaño especificado puede ser el ancho o alto. El ancho de un icono siempre es igual a su alto.

Valor devuelto

Tipo: HRESULT

Devuelve S_OK si la función extrajo el icono o S_FALSE si la aplicación que realiza la llamada debe extraer el icono.

Comentarios

La ubicación del icono y el índice son los mismos valores devueltos por el método IExtractIcon::GetIconLocation . Si la función IExtractIcon::Extract devuelve S_FALSE, estos valores deben especificar un nombre de archivo de icono e índice que forman parámetros legales para una llamada a ExtractIcon. Si IExtractIcon::Extract no devuelve S_FALSE, no se deben realizar suposiciones sobre los significados de los parámetros pszFile y nIconIndex .

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	shlobj_core.h
Archivo DLL	Shell32.dll (versión 4.0 o posterior)

Consulte también

IExtractIcon