状态枚举 (gdiplustypes.h)

Status 枚举指示 Windows GDI+ 方法调用的结果。

语法

typedef enum Status {
  Ok = 0,
  GenericError = 1,
  InvalidParameter = 2,
  OutOfMemory = 3,
  ObjectBusy = 4,
  InsufficientBuffer = 5,
  NotImplemented = 6,
  Win32Error = 7,
  WrongState = 8,
  Aborted = 9,
  FileNotFound = 10,
  ValueOverflow = 11,
  AccessDenied = 12,
  UnknownImageFormat = 13,
  FontFamilyNotFound = 14,
  FontStyleNotFound = 15,
  NotTrueTypeFont = 16,
  UnsupportedGdiplusVersion = 17,
  GdiplusNotInitialized = 18,
  PropertyNotFound = 19,
  PropertyNotSupported = 20,
  ProfileNotFound = 21
} ;

常量

Ok 值： 0 指示方法调用成功。
GenericError 值：1 指示方法调用上存在错误，该错误被标识为此枚举的其他元素定义的错误。
InvalidParameter 值： 2 指示传递给方法的参数之一无效。
OutOfMemory 值： 3 指示操作系统内存不足，无法分配内存来处理方法调用。 有关构造函数如何使用 OutOfMemory 状态的说明，请参阅本主题末尾的“备注”部分。
ObjectBusy 值： 4 指示 API 调用中指定的参数之一已在另一个线程中使用。
InsufficientBuffer 值： 5 指示在 API 调用中指定为参数的缓冲区不够大，无法容纳要接收的数据。
NotImplemented 值： 6 指示未实现方法。
Win32Error 值： 7 指示该方法生成了 Win32 错误。
WrongState 值： 8 指示对象处于无效状态以满足 API 调用。 例如，调用 笔：：GetColor 不是单一纯色的笔会导致 错误状态 。
Aborted 值： 9 指示方法已中止。
FileNotFound 值： 10 指示找不到指定的图像文件或图元文件。
ValueOverflow 值： 11 指示该方法执行了生成数值溢出的算术运算。
AccessDenied 值： 12 指示不允许对指定的文件执行写入操作。
UnknownImageFormat 值： 13 指示指定的图像文件格式未知。
FontFamilyNotFound 值： 14 指示找不到指定的字体系列。 字体系列名称不正确或字体系列未安装。
FontStyleNotFound 值： 15 指示指定的样式不适用于指定的字体系列。
NotTrueTypeFont 值： 16 指示从 检索到的字体 HDC 或 LOGFONT 不是 TrueType 字体，不能与 GDI+ 一起使用。
UnsupportedGdiplusVersion 值： 17 指示系统上安装的 GDI+ 版本与编译应用程序的版本不兼容。
GdiplusNotInitialized 值： 18 指示 GDI+API 未处于初始化状态。 若要运行，所有 GDI+ 对象都要求 GDI+ 处于初始化状态。 通过调用 初始化 GDI+ GdiplusStartup。
PropertyNotFound 值： 19 指示映像中不存在指定的属性。
PropertyNotSupported 值： 20 指示指定的属性不受图像格式支持，因此无法设置。
ProfileNotFound 值： 21 指示未找到以 CMYK 格式保存图像所需的颜色配置文件。

注解

如果构造 GDI+ 对象，然后立即调用该对象的 GetLastStatus 方法，则可以确定构造函数是成功还是失败。 在这种情况下，即使有足够的内存可用于创建对象， GetLastStatus 也可能返回 OutOfMemory 。 多个 GDI+ 构造函数在失败时将状态设置为 OutOfMemory ，而不考虑失败的原因。

要求

要求	值
最低受支持的客户端	Windows Vista [仅限桌面应用]
最低受支持的服务器	Windows Server 2008 [仅限桌面应用]
标头	gdiplustypes.h (包括 Gdiplus.h)