Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
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 |