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

Article
03/02/2024

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

Partager via