CLRES_FUNCTION_TABLE structure (resapi.h)

Article
06/24/2021

Describes a function table for any version of the Resource API.

Syntax

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;

Members

TableSize

Count of bytes in the structure.

This can contain one of these values:

CLRES_V1_FUNCTION_SIZE

The size of the function table for Resource API version 1.0.

CLRES_V2_FUNCTION_SIZE

The size of the function table for Resource API version 2.0.

Windows Server 2008 R2: This value is not supported before Windows Server 2012.

CLRES_V3_FUNCTION_SIZE

The size of the function table for Resource API version 3.0.

Windows Server 2008 R2 and Windows Server 2012: This value is not supported before Windows Server 2012 R2.

Version

The supported version of the Resource API.

This can contain one of these values:

CLRES_VERSION_V1_00 (0x100)

Resource API version 1.0.

CLRES_VERSION_V2_00 (0x200)

Resource API version 2.0.

Windows Server 2008 R2: This value is not supported before Windows Server 2012.

CLRES_VERSION_V3_00 (0x300)

Resource API version 3.0.

Windows Server 2008 R2 and Windows Server 2012: This value is not supported before Windows Server 2012 R2.

DUMMYUNIONNAME

DUMMYUNIONNAME.V1Functions

A CLRES_V1_FUNCTIONS structure that contains the table of entry points included in the Resource API version 1.0.

DUMMYUNIONNAME.V2Functions

A CLRES_V2_FUNCTIONS structure that contains the table of entry points included in the Resource API version 2.0.

Windows Server 2008 R2: This member was added in Windows Server 2012.

DUMMYUNIONNAME.V3Functions

A CLRES_V3_FUNCTIONS structure that contains the table of entry points included in the Resource API version 3.0.

Windows Server 2008 R2 and Windows Server 2012: This member was added in Windows Server 2012 R2.

DUMMYUNIONNAME.V4Functions

Remarks

Only the first two members are guaranteed to be at the same offset within the CLRES_FUNCTION_TABLE structure. All other entries within this structure are dependent on the Resource API version supported.

The V1Functions member is a CLRES_V1_FUNCTIONS structure containing pointers to all Resource API entry points except Startup. All pointers must be non-NULL except for pointers to the following entry point functions:

For more information, see Implementing Resource DLLs.

To create a function table for version 1.0 of the Resource API, use the CLRES_V1_FUNCTION_TABLE macro.

Examples

See Defining Structures and Constants in Implementing Resource DLLs.

Requirements

Requirement	Value
Minimum supported client	None supported
Minimum supported server	Windows Server 2008 Enterprise, Windows Server 2008 Datacenter
Header	resapi.h