Image：：GetPropertyIdList 方法 (gdiplusheaders.h)

项目
03/05/2024

Image：：GetPropertyIdList 方法获取此 Image 对象的元数据中使用的属性标识符的列表。

语法

Status GetPropertyIdList(
  [in]  UINT   numOfProperty,
  [out] PROPID *list
);

参数

[in] numOfProperty

类型： UINT

指定列表数组中的元素数的整数。调用 Image：：GetPropertyCount 方法以确定此数字。

[out] list

类型： PROPID*

指向接收属性标识符的数组的指针。

返回值

类型：状态

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

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

注解

Image：：GetPropertyIdList 方法返回 PROPID数组。在调用 Image：：GetPropertyIdList 之前，必须分配一个足够大的缓冲区来接收该数组。可以调用 Image 对象的 Image：：GetPropertyCount 方法来确定所需缓冲区的大小。缓冲区的大小应为 Image：：GetPropertyCount 的返回值乘以 sizeof ( PROPID) 。

示例

以下示例基于 JPEG 文件创建 Image 对象。代码调用该 Image 对象的 Image：：GetPropertyIdList 方法，以找出图像中存储的元数据类型。

#include <windows.h>
#include <gdiplus.h>
#include <stdio.h>
using namespace Gdiplus;

INT main()
{
   GdiplusStartupInput gdiplusStartupInput;
   ULONG_PTR gdiplusToken;
   GdiplusStartup(&gdiplusToken, &gdiplusStartupInput, NULL);

   UINT count = 0; 
   Image* image = new Image(L"FakePhoto.jpg");

   // How many types of metadata are in the image?
   count = image->GetPropertyCount();
   if(count == 0)
      return 0;

   // Allocate a buffer to receive an array of PROPIDs.
   PROPID* propIDs = new PROPID[count];

   image->GetPropertyIdList(count, propIDs);

   // List the retrieved IDs.
   for(UINT j = 0; j < count; ++j)
      printf("%x\n", propIDs[j]);

   delete [] propIDs;
   delete image;   
  
   GdiplusShutdown(gdiplusToken);
   return 0;
}

前面的代码以及特定文件 FakePhoto.jpg 生成了以下输出：

前面的输出显示每个属性标识符的十六进制值。可以在 Gdiplusimaging.h 中查找这些数字，并发现它们表示以下属性标记。

十六进制值	属性标记
0x0320	PropertyTagImageTitle
0x010f	PropertyTagEquipMake
0x0110	PropertyTagEquipModel
0x9003	PropertyTagExifDTOriginal
0x829a	PropertyTagExifExposureTime
0x5090	PropertyTagLuminanceTable
0x5091	PropertyTagChrominanceTable

要求

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