Win32 API 日本語リファレンス
ホームUI.WindowsAndMessaging › MrmDumpType

MrmDumpType

列挙型
基底型i4

メンバー 3

名前10進16進
MrmDumpType_Basic00x0
MrmDumpType_Detailed10x1
MrmDumpType_Schema20x2

公式ドキュメント

MrmDumpPri... 関数のいずれかを呼び出すときに生成する PRI ファイルダンプの種類を指定する定数を定義します。

解説(Remarks)

PRI ファイルは文書化されていないバイナリ形式で格納されるため、その内容を確認する唯一の方法は、MrmDumpPri... 関数のいずれかを使用して XML にダンプすることです。XML へのダンプは、次の 3 つの目的に役立ちます。

  1. XML は人間が読める形式であるため、ファイルの内容を確認したり、解決されないリソースや修飾が正しくない候補などの問題をデバッグしたりできます。
  2. XML は機械可読でもあるため、ツールによって PRI ファイルを操作し、中間の XML 形式を介して新しい PRI ファイルを生成できます。
    • XML ダンプを PRI ファイルに戻すための組み込みのしくみは無いことに注意してください。リソースインデクサーを作成し、 XML ファイルからリソース候補を追加して新しいファイルを書き出すことにより、手動で行う必要があります。
  3. Schema ダンプ種類は、バージョン管理された PRI ファイルの作成に使用できます。

Basic ダンプ種類は、ほとんどのデバッグ目的には十分です。埋め込みバイナリデータを除く、すべてのリソース名と候補値が一覧表示されます。 ただし、埋め込みバイナリデータはいずれにせよ人間が読める形式ではないため、通常は問題になりません。

Detailed ダンプ種類は最も完全で、BASE64 でエンコードされた埋め込みバイナリデータも含まれますが、読みにくくする余分なデータが多数含まれます (特に大きな埋め込みバイナリリソースがある場合)。Detailed ダンプファイルは、元の PRI ファイルへのラウンドトリップに使用できます。

Schema ダンプ種類は最も小さいダンプ種類であり、PRI ファイル内のリソース名とインデックスに関する情報 (ファイルの「スキーマ」) のみが含まれます。 Schema ダンプは、MrmCreateResourceIndexerFromPreviousSchema... 関数のいずれかと共に使用して、バージョン管理可能な PRI ファイルを作成できます。 詳細については、MrmCreateResourceIndexerFromPreviousSchemaFile解説 を参照してください。 Schema ダンプに一覧表示されたリソースが実際に PRI ファイル内に候補を定義しているという保証は無いため、「不足している」リソースのエラーのデバッグにはこれでは不十分です。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp)

各言語での定義

列挙メンバーの定義。HSP タブは #define global(値は16進)。

typedef enum MrmDumpType : int {
    MrmDumpType_Basic = 0,
    MrmDumpType_Detailed = 1,
    MrmDumpType_Schema = 2
} MrmDumpType;
public enum MrmDumpType : int
{
    MrmDumpType_Basic = 0,
    MrmDumpType_Detailed = 1,
    MrmDumpType_Schema = 2,
}
Public Enum MrmDumpType As Integer
    MrmDumpType_Basic = 0
    MrmDumpType_Detailed = 1
    MrmDumpType_Schema = 2
End Enum
import enum

class MrmDumpType(enum.IntEnum):
    MrmDumpType_Basic = 0
    MrmDumpType_Detailed = 1
    MrmDumpType_Schema = 2
// MrmDumpType
pub const MrmDumpType_Basic: i32 = 0;
pub const MrmDumpType_Detailed: i32 = 1;
pub const MrmDumpType_Schema: i32 = 2;
// MrmDumpType
const (
	MrmDumpType_Basic int32 = 0
	MrmDumpType_Detailed int32 = 1
	MrmDumpType_Schema int32 = 2
)
const
  MrmDumpType_Basic = 0;
  MrmDumpType_Detailed = 1;
  MrmDumpType_Schema = 2;
// MrmDumpType
pub const MrmDumpType_Basic: i32 = 0;
pub const MrmDumpType_Detailed: i32 = 1;
pub const MrmDumpType_Schema: i32 = 2;
const
  MrmDumpType_Basic* = 0
  MrmDumpType_Detailed* = 1
  MrmDumpType_Schema* = 2
enum MrmDumpType : int {
    MrmDumpType_Basic = 0,
    MrmDumpType_Detailed = 1,
    MrmDumpType_Schema = 2,
}
#define global MrmDumpType_Basic    0x0
#define global MrmDumpType_Detailed 0x1
#define global MrmDumpType_Schema   0x2