Función SHCreateFileExtractIconA (shlobj_core.h)

[SHCreateFileExtractIcon está disponible para su uso en los sistemas operativos especificados en la sección Requisitos. Puede modificarse o no estar disponible en versiones posteriores.

Crea un controlador IExtractIcon predeterminado para un objeto de sistema de archivos. Las extensiones de espacio de nombres que muestran objetos del sistema de archivos suelen usar esta función. Los atributos de extensión y archivo derivan todo lo necesario para un extractor de iconos simple.

Sintaxis

SHSTDAPI SHCreateFileExtractIconA(
  [in] LPCSTR pszFile,
  [in] DWORD  dwFileAttributes,
  [in] REFIID riid,
       void   **ppv
);

Parámetros

[in] pszFile

Tipo: LPCTSTR

Puntero a una cadena terminada en null que especifica el objeto del sistema de archivos. El búfer no debe superar MAX_PATH caracteres de longitud.

[in] dwFileAttributes

Tipo: DWORD

Combinación de una o varias marcas de atributo de archivo (FILE_ATTRIBUTE_* valores tal y como se define en Winnt.h) que especifican el tipo de objeto.

[in] riid

Tipo: REFIID

Referencia al identificador de interfaz deseado de la interfaz del extractor de iconos que se va a crear. Debe ser IID_IExtractIconA o IID_IExtractIconW.

ppv

Tipo: void**

Cuando se devuelve esta función, contiene el puntero de interfaz solicitado en riid. Esto suele ser IExtractIcon.

Valor devuelto

Tipo: HRESULT

Si esta función se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Requisitos

Cliente mínimo compatible	Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	shlobj_core.h (incluya Shlobj.h)
Library	Shell32.lib
Archivo DLL	Shell32.dll (versión 5.0 o posterior)