Partager via


Image ::FindFirstItem, méthode (gdiplusheaders.h)

La méthode Image ::FindFirstItem récupère la description et la taille des données du premier élément de métadonnées de cet objet Image .

Syntaxe

Status FindFirstItem(
  [in, out] ImageItemData *item
);

Paramètres

[in, out] item

Type : ImageItemData*

Pointeur vers un objet ImageItemData . Lors de l’entrée, le membre Desc pointe vers une mémoire tampon (allouée par l’appelant) suffisamment grande pour contenir la description des métadonnées (1 octet pour JPEG, 4 octets pour PNG, 11 octets pour GIF), et le membre DescSize spécifie la taille (1, 4 ou 6) de la mémoire tampon pointée par Desc. Lors de la sortie, la mémoire tampon pointée par Desc reçoit la description des métadonnées, et le membre DataSize reçoit la taille, en octets, des métadonnées elles-mêmes.

Valeur retournée

Type : État

Si la méthode réussit, elle retourne Ok, qui est un élément de l’énumération Status .

Si la méthode échoue, elle retourne l’un des autres éléments de l’énumération Status .

Remarques

Utilisez Image ::FindFirstItem avec Image ::FindNextItem pour énumérer les éléments de métadonnées, y compris les métadonnées personnalisées, stockés dans une image. Image ::FindFirstItem et Image ::FindNextItem n’énumèrent pas les éléments de métadonnées stockés par la méthode Image ::SetPropertyItem .

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2008 [applications de bureau uniquement]
Plateforme cible Windows
En-tête gdiplusheaders.h (inclure Gdiplus.h)
Bibliothèque Gdiplus.lib
DLL Gdiplus.dll

Voir aussi

Image

Image ::GetItemData