Image::FindFirstItem 方法 (gdiplusheaders.h)

Image::FindFirstItem 方法检索此 Image 对象中第一个元数据项的说明和数据大小。

语法

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

参数

[in, out] item

类型: ImageItemData*

指向 ImageItemData 对象的指针。 输入时,Desc 成员指向调用方分配的缓冲区 () 足够大,以便保存元数据说明 (1 字节(对于 JPEG),4 个字节用于 PNG,11 个字节用于 GIF) ,并且 DescSize 成员指定由 Desc 指向的缓冲区的大小 (1、4 或 6) 。 输出时,Desc 指向的缓冲区接收元数据说明,DataSize 成员接收元数据本身的大小(以字节为单位)。

返回值

类型: 状态

如果该方法成功,则返回 Ok,这是 Status 枚举的元素。

如果方法失败,它将返回 Status 枚举的其他元素之一。

注解

使用 Image::FindFirstItemImage::FindNextItem 枚举存储在图像中的元数据项,包括自定义元数据。 Image::FindFirstItemImage::FindNextItem 不枚举 Image::SetPropertyItem 方法存储的元数据项。

要求

要求
最低受支持的客户端 Windows Vista [仅限桌面应用]
最低受支持的服务器 Windows Server 2008 [仅限桌面应用]
目标平台 Windows
标头 gdiplusheaders.h (包括 Gdiplus.h)
Library Gdiplus.lib
DLL Gdiplus.dll

另请参阅

图像

Image::GetItemData