次の方法で共有

IDebugHostSymbols::CreateModuleSignature メソッド (dbgmodel.h)

  • [アーティクル]

CreateModuleSignature メソッドはシグネチャを作成します。このシグネチャを使用して、名前および必要に応じてバージョン別に特定のモジュールのセットを照合できます。 モジュール署名には、次の 3 つのコンポーネントがあります。

  • 名前: 一致するモジュールには、シグネチャ内の名前と完全に大文字と小文字を区別しない一致する名前が必要です

  • 最小バージョン: 指定した場合、一致するモジュールには、少なくともこのバージョンと同じ高さである最小バージョンが必要です。 バージョンは "A.B.C.D" 形式で指定され、後続の各部分は以前よりも重要度が低くなります。 最初のセグメントのみが必須です。

  • 最大バージョン: 指定した場合、一致するモジュールには、このバージョン以下の最大バージョンが必要です。 バージョンは "A.B.C.D" 形式で指定され、後続の各部分は以前よりも重要度が低くなります。 最初のセグメントのみが必須です。

構文

HRESULT CreateModuleSignature(
  PCWSTR                    pwszModuleName,
  PCWSTR                    pwszMinVersion,
  PCWSTR                    pwszMaxVersion,
  IDebugHostModuleSignature **ppModuleSignature
);

パラメーター

pwszModuleName

シグネチャと一致させるためにモジュールに必要な名前 (大文字と小文字は区別されません)。

pwszMinVersion

シグネチャと一致させるためにモジュールに必要な最小バージョン。 この引数が nullptr の場合、署名に一致するために必要な最小バージョンはありません。 バージョンは"A.B.C.D" 形式の文字列として指定され、最初のコンポーネントのみが必要であり、後続のコンポーネントの重要度が低くなります。

pwszMaxVersion

シグネチャと一致させるためにモジュールに含めることができる最大バージョン。 この引数が nullptr の場合、署名に一致するために必要なバージョン番号に上限はありません。 バージョンは"A.B.C.D" 形式の文字列として指定され、最初のコンポーネントのみが必要であり、後続のコンポーネントの重要度が低くなります。

ppModuleSignature

作成されたモジュール署名オブジェクトがここで返されます。

戻り値

このメソッドは、成功または失敗を示す HRESULT を返します。

注釈

サンプル コード

ComPtr<IDebugHost> spHost; /* get the host */

ComPtr<IDebugHostSymbols> spSym;
if (SUCCEEDED(spHost.As(&spSym)))
{
    ComPtr<IDebugHostModuleSignature> spBasicSignature;
    if (SUCCEEDED(spSym->CreateModuleSignature(
        L"Windows.UI.Xaml.dll", 
        nullptr, 
        nullptr, 
        &spBasicSignature)))
    {
        // spBasicSignature is a signature which will match any module 
        // named "Windows.UI.Xaml.dll" regardless of version.
    }

    ComPtr<IDebugHostModuleSignature> spVersionedSignature;
    if (SUCCEEDED(spSym->CreateModuleSignature(
        L"Windows.UI.Xaml.dll", 
        "6.3", 
        "10.0.0.0", 
        &spVersionedSignature)))
    {
        // spVersionedSignature is a signature which will match a module named
        // "Windows.UI.Xaml.dll" whose version is >= 6.3(.0.0) and whose 
        // version <= 10.0.0.0
    }
}

要件

要件 値
Header dbgmodel.h

こちらもご覧ください

IDebugHostSymbols インターフェイス