Partager via


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

[IShellImageStore est pris en charge via Windows XP. Il n’est pas pris en charge dans les systèmes d’exploitation ultérieurs.]

Obtient un handle pour une image dans le cache.

Syntaxe

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

Paramètres

[in] pszName

Type : PCWSTR

Pointeur vers une chaîne terminée par null qui spécifie le chemin d’accès au fichier qui contient l’image.

dwMode

Type : DWORD

Mode d’instanciation de stockage spécifié par l’une des valeurs STGM .

[out] phImage

Type : HBITMAP*

Pointeur vers le handle de la bitmap.

Valeur retournée

Type : HRESULT

Retourne le résultat de ISequentialStream ::Read si le processus a réussi. Sinon, retourne l’une des valeurs suivantes :

Code de retour Description
E_UNEXPECTED
Le stockage n’est pas ouvert.
E_FAIL
Le flux est introuvable.

Remarques

Il incombe à l’appelant de libérer le handle après un appel à cette méthode.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge Windows 2000 Server [applications de bureau uniquement]
Plateforme cible Windows
En-tête shlobj.h
DLL Shell32.dll (version 5.0 ou ultérieure)