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 |