Método IShellImageStore::GetEntry (shlobj.h)

[IShellImageStore se admite a través de Windows XP. No se admite en sistemas operativos posteriores.

Obtiene un identificador de una imagen en la memoria caché.

Sintaxis

HRESULT GetEntry(
  [in]  PCWSTR  pszName,
        DWORD   dwMode,
  [out] HBITMAP *phImage
);

[in] pszName

Tipo: PCWSTR

Puntero a una cadena terminada en null que especifica la ruta de acceso al archivo que contiene la imagen.

dwMode

Tipo: DWORD

Modo de creación de instancias de almacenamiento especificado por uno de los valores STGM .

[out] phImage

Tipo: HBITMAP*

Puntero al identificador del mapa de bits.

Tipo: HRESULT

Devuelve el resultado de ISequentialStream::Read si el proceso se realizó correctamente. De lo contrario, devuelve uno de los valores siguientes:

Código devuelto	Descripción
E_UNEXPECTED	El almacenamiento no está abierto.
E_FAIL	No se encuentra la secuencia.

Es responsabilidad del autor de la llamada liberar el identificador después de una llamada a este método.

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