CLRES_FUNCTION_TABLE 结构 (resapi.h)

项目
08/25/2023

描述任何资源 API 版本的函数表。

语法

typedef struct CLRES_FUNCTION_TABLE {
  DWORD TableSize;
  DWORD Version;
  union {
    CLRES_V1_FUNCTIONS V1Functions;
    CLRES_V2_FUNCTIONS V2Functions;
    CLRES_V3_FUNCTIONS V3Functions;
    CLRES_V4_FUNCTIONS V4Functions;
  } DUMMYUNIONNAME;
} CLRES_FUNCTION_TABLE, *PCLRES_FUNCTION_TABLE;

成员

TableSize

结构中的字节计数。

这可以包含以下值之一：

CLRES_V1_FUNCTION_SIZE

资源 API 版本 1.0 的函数表的大小。

CLRES_V2_FUNCTION_SIZE

资源 API 版本 2.0 的函数表的大小。

Windows Server 2008 R2： 在 Windows Server 2012 之前不支持此值。

CLRES_V3_FUNCTION_SIZE

资源 API 版本 3.0 的函数表的大小。

Windows Server 2008 R2 和 Windows Server 2012： 在 Windows Server 2012 R2 之前不支持此值。

Version

支持的资源 API 版本。

这可以包含以下值之一：

CLRES_VERSION_V1_00 (0x100)

资源 API 版本 1.0。

CLRES_VERSION_V2_00 (0x200)

资源 API 版本 2.0。

Windows Server 2008 R2： 在 Windows Server 2012 之前不支持此值。

CLRES_VERSION_V3_00 (0x300)

资源 API 版本 3.0。

Windows Server 2008 R2 和 Windows Server 2012： 在 Windows Server 2012 R2 之前不支持此值。

DUMMYUNIONNAME

DUMMYUNIONNAME.V1Functions

包含资源 API 版本 1.0 中包含的入口点表的 CLRES_V1_FUNCTIONS 结构。

DUMMYUNIONNAME.V2Functions

包含资源 API 版本 2.0 中包含的入口点表的 CLRES_V2_FUNCTIONS 结构。

Windows Server 2008 R2： 此成员已添加到 Windows Server 2012 中。

DUMMYUNIONNAME.V3Functions

包含资源 API 版本 3.0 中包含的入口点表的CLRES_V3_FUNCTIONS 结构。

Windows Server 2008 R2 和 Windows Server 2012： 此成员已添加到 Windows Server 2012 R2 中。

DUMMYUNIONNAME.V4Functions

注解

保证只有前两个成员在 CLRES_FUNCTION_TABLE 结构中处于相同的偏移量。此结构中的所有其他条目都依赖于支持的资源 API 版本。

V1Functions 成员是一个CLRES_V1_FUNCTIONS结构，包含指向除 Startup 之外的所有资源 API 入口点的指针。除指向以下入口点函数的指针外，所有指针都必须为非 NULL ：

有关详细信息，请参阅实现资源 DLL。

若要为资源 API 1.0 版创建函数表，请使用 CLRES_V1_FUNCTION_TABLE 宏。

示例

请参阅在实现资源 DLL 中定义结构和常量。

要求


最低受支持的客户端	无受支持的版本
最低受支持的服务器	Windows Server 2008 企业版、Windows Server 2008 Datacenter
标头	resapi.h