CLRES_FUNCTION_TABLE構造体 (resapi.h)

[アーティクル]
08/25/2023

任意のバージョンの Resource 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

Resource API バージョン 1.0 の関数テーブルのサイズ。

CLRES_V2_FUNCTION_SIZE

Resource API バージョン 2.0 の関数テーブルのサイズ。

Windows Server 2008 R2: この値は、Windows Server 2012 より前はサポートされていません。

CLRES_V3_FUNCTION_SIZE

Resource API バージョン 3.0 の関数テーブルのサイズ。

Windows Server 2008 R2 と Windows Server 2012: この値は、Windows Server 2012 R2 より前ではサポートされていません。

Version

Resource API のサポートされているバージョン。

これには、次のいずれかの値を含めることができます。

CLRES_VERSION_V1_00 (0x100)

Resource API バージョン 1.0。

CLRES_VERSION_V2_00 (0x200)

Resource API バージョン 2.0。

Windows Server 2008 R2: この値は、Windows Server 2012 より前はサポートされていません。

CLRES_VERSION_V3_00 (0x300)

Resource API バージョン 3.0。

Windows Server 2008 R2 と Windows Server 2012: この値は、Windows Server 2012 R2 より前ではサポートされていません。

DUMMYUNIONNAME

DUMMYUNIONNAME.V1Functions

Resource API バージョン 1.0 に含まれるエントリポイントのテーブルを含む CLRES_V1_FUNCTIONS 構造体。

DUMMYUNIONNAME.V2Functions

Resource API バージョン 2.0 に含まれるエントリポイントのテーブルを含む CLRES_V2_FUNCTIONS 構造体。

Windows Server 2008 R2: このメンバーは、Windows Server 2012 で追加されました。

DUMMYUNIONNAME.V3Functions

Resource API バージョン 3.0 に含まれるエントリポイントのテーブルを含む CLRES_V3_FUNCTIONS 構造体。

Windows Server 2008 R2 と Windows Server 2012: このメンバーは、Windows Server 2012 R2 で追加されました。

DUMMYUNIONNAME.V4Functions

解説

最初の 2 つのメンバーのみが、 CLRES_FUNCTION_TABLE 構造体内の同じオフセットにあることが保証されます。この構造体内の他のすべてのエントリは、サポートされている Resource API のバージョンによって異なります。

V1Functions メンバーは、Startup を除くすべての Resource API エントリポイントへのポインターを含むCLRES_V1_FUNCTIONS構造体です。次のエントリポイント関数へのポインターを除き、すべてのポインターは NULL 以外である必要があります。

詳細については、「リソース DLL の実装」を参照してください。

Resource API のバージョン 1.0 の関数テーブルを作成するには、 CLRES_V1_FUNCTION_TABLE マクロを使用します。

例

「リソース DLL の実装」の「構造体と定数の定義」を参照してください。

要件


サポートされている最小のクライアント	サポートなし
サポートされている最小のサーバー	Windows Server 2008 Enterprise、Windows Server 2008 Datacenter
Header	resapi.h

次の方法で共有