Export (0) Print
Expand All

IShellImageStore::GetEntry method

[IShellImageStore is supported through Windows XP. It is not supported in later operating systems.]

Gets a handle to an image in the cache.

Syntax


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

Parameters

pszName [in]

Type: PCWSTR

A pointer to a null-terminated string that specifies the path to the file that contains the image.

dwMode

Type: DWORD

The storage instantiation mode specified by one of the STGM values.

phImage [out]

Type: HBITMAP*

A pointer to the handle of the bitmap.

Return value

Type: HRESULT

Returns the result of ISequentialStream::Read if the process was successful. Otherwise, returns one of the following values:

Return codeDescription
E_UNEXPECTED

Storage is not open.

E_FAIL

The stream cannot be found.

 

Remarks

It is the caller's responsibility to free the handle after a call to this method.

Requirements

Minimum supported client

Windows 2000 Professional [desktop apps only]

Minimum supported server

Windows 2000 Server [desktop apps only]

Header

Shlobj.h

DLL

Shell32.dll (version 5.0 or later)

 

 

Community Additions

ADD
Show:
© 2014 Microsoft