Método Image::FindFirstItem (gdiplusheaders.h)

  • Artículo

El método Image::FindFirstItem recupera la descripción y el tamaño de los datos del primer elemento de metadatos de este objeto Image .

Sintaxis

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

Parámetros

[in, out] item

Tipo: ImageItemData*

Puntero a un objeto ImageItemData . En la entrada, el miembro Desc apunta a un búfer (asignado por el autor de la llamada) lo suficientemente grande como para contener la descripción de metadatos (1 byte para JPEG, 4 bytes para PNG, 11 bytes para GIF) y el miembro DescSize especifica el tamaño (1, 4 o 6) del búfer al que apunta Desc. En la salida, el búfer al que apunta Desc recibe la descripción de los metadatos y el miembro DataSize recibe el tamaño, en bytes, de los propios metadatos.

Valor devuelto

Tipo: Estado

Si el método se realiza correctamente, devuelve Ok, que es un elemento de la enumeración Status .

Si se produce un error en el método, devuelve uno de los otros elementos de la enumeración Status .

Comentarios

Use Image::FindFirstItem junto con Image::FindNextItem para enumerar los elementos de metadatos, incluidos los metadatos personalizados, almacenados en una imagen. Image::FindFirstItem e Image::FindNextItem no enumeran los elementos de metadatos almacenados por el método Image::SetPropertyItem .

Requisitos

Requisito Value
Cliente mínimo compatible Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado gdiplusheaders.h (include Gdiplus.h)
Library Gdiplus.lib
Archivo DLL Gdiplus.dll

Consulte también

Imagen

Image::GetItemData