Partager via

Méthode IShellImageData ::D ecode (shimgdata.h)

Décode le fichier image, en définissant l’état.

Syntaxe

HRESULT Decode(
  [in] DWORD dwFlags,
  [in] ULONG cxDesired,
  [in] ULONG cyDesired
);

Paramètres

[in] dwFlags

Type : DWORD

L’un des indicateurs suivants.

SHIMGDEC_DEFAULT (0x00)

Créez une image complète.

SHIMGDEC_THUMBNAIL (0x01)

Décodez uniquement l’image miniature.

SHIMGDEC_LOADFULL (0x02)

Chargez l’intégralité du fichier image en mémoire.

[in] cxDesired

Type : ULONG

Taille horizontale souhaitée de l’image décodée. Ce paramètre n’est utilisé que si l’indicateur SHIMGDEC_THUMBNAIL est défini. Si l’indicateur SHIMGDEC_DEFAULT est défini à la place, cette valeur est ignorée.

[in] cyDesired

Type : ULONG

Taille verticale souhaitée de l’image décodée. Ce paramètre n’est utilisé que si l’indicateur SHIMGDEC_THUMBNAIL est défini. Si l’indicateur SHIMGDEC_DEFAULT est défini à la place, cette valeur est ignorée.

Valeur retournée

Type : HRESULT

Retourne S_OK en cas de réussite, ou une valeur d’erreur dans le cas contraire, y compris les éléments suivants :

Code de retour Description
E_FAIL
 Le fichier n’a pas pu être chargé ou l’application appelante a arrêté le processus de décodage via un appel à un IShellImageDataAbort inscrit (voir IShellImageData ::RegisterAbort pour plus d’informations).
E_OUTOFMEMORY
 L’objet interne ne peut pas être instancié.
E_NOTIMPL
 Le chemin utilisé pour créer cette instance d’IShellImageData était une URL.
S_FALSE
 L’image a déjà été décodée.

Remarques

IShellImageData ::D ecode doit être appelé avant d’appeler la plupart des méthodes IShellImageData . Si vous ne le faites pas, ces méthodes échouent.

IShellImageData ::D ecode tente de conserver le rapport d’aspect de l’image d’origine, de sorte que l’une des valeurs passées dans cxDesired ou cyDesired peut être remplacée pour ce faire.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2003 [applications de bureau uniquement]
Plateforme cible Windows
En-tête shimgdata.h
DLL Shell32.dll
  • Last updated on