Image::FindFirstItem-Methode (gdiplusheaders.h)

Die Image::FindFirstItem-Methode ruft die Beschreibung und die Datengröße des ersten Metadatenelements in diesem Image-Objekt ab.

Syntax

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

Parameter

[in, out] item

Typ: ImageItemData*

Zeiger auf ein ImageItemData-Objekt . Bei der Eingabe zeigt das Desc-Member auf einen Puffer (vom Aufrufer zugeordnet), der groß genug ist, um die Metadatenbeschreibung (1 Byte für JPEG, 4 Bytes für PNG, 11 Bytes für GIF) aufzunehmen, und das DescSize-Element gibt die Größe (1, 4 oder 6) des Puffers an, auf den von Desc verwiesen wird. Bei der Ausgabe empfängt der Puffer, auf den Desc verweist, die Metadatenbeschreibung, und das DataSize-Element empfängt die Größe der Metadaten selbst in Bytes.

Rückgabewert

Typ: Status

Wenn die Methode erfolgreich ist, gibt sie OK zurück, ein Element der Status-Enumeration .

Wenn die Methode fehlschlägt, gibt sie eines der anderen Elemente der Status-Enumeration zurück.

Hinweise

Verwenden Sie Image::FindFirstItem zusammen mit Image::FindNextItem , um die Metadatenelemente aufzulisten, einschließlich benutzerdefinierter Metadaten, die in einem Image gespeichert sind. Image::FindFirstItem und Image::FindNextItem werden die Metadatenelemente, die von der Image::SetPropertyItem-Methode gespeichert sind, nicht aufgezählt.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	gdiplusheaders.h (include Gdiplus.h)
Bibliothek	Gdiplus.lib
DLL	Gdiplus.dll

Weitere Informationen

Image

Image::GetItemData