IDebugHostSymbols::CreateModuleSignature-Methode (dbgmodel.h)

Die CreateModuleSignature-Methode erstellt eine Signatur, die verwendet werden kann, um eine Gruppe bestimmter Module anhand des Namens und optional nach Version abzugleichen. Es gibt drei Komponenten für eine Modulsignatur:

• A name: a matching module must have a name which is an exact case insensitive match against the name in the signature

• Eine Mindestversion: Wenn angegeben, muss ein übereinstimmende Modul mindestens eine Mindestversion aufweisen, die mindestens so hoch ist wie diese Version. Versionen werden im Format "A.B.C.D" angegeben, wobei jeder nachfolgende Teil weniger wichtig als der vorherige Teil ist. Nur das erste Segment ist obligatorisch.

• Eine maximale Version: Wenn angegeben, muss ein übereinstimmende Modul eine maximale Version aufweisen, die nicht höher als diese Version ist. Versionen werden im Format "A.B.C.D" angegeben, wobei jeder nachfolgende Teil weniger wichtig als der vorherige Teil ist. Nur das erste Segment ist obligatorisch.

Syntax

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

Parameter

pwszModuleName

Der Name, über den ein Modul verfügen muss, um der Signatur zu entsprechen (Groß-/Kleinschreibung wird nicht beachtet).

pwszMinVersion

Die Mindestversion, über die ein Modul verfügen muss, um der Signatur zu entsprechen. Wenn dieses Argument nullptr ist, ist keine Mindestversion erforderlich, um der Signatur zu entsprechen. Versionen werden als Zeichenfolgen im Format "A.B.C.D" angegeben, wobei nur die erste Komponente erforderlich ist und nachfolgende Komponenten weniger wichtig sind.

pwszMaxVersion

Die maximale Version, über die ein Modul verfügen kann, um der Signatur zu entsprechen. Wenn dieses Argument nullptr ist, gibt es keine Obergrenze für die Versionsnummer, die für die Übereinstimmung mit der Signatur erforderlich ist. Versionen werden als Zeichenfolgen im Format "A.B.C.D" angegeben, wobei nur die erste Komponente erforderlich ist und nachfolgende Komponenten weniger wichtig sind.

ppModuleSignature

Das erstellte Modulsignaturobjekt wird hier zurückgegeben.

Rückgabewert

Diese Methode gibt HRESULT zurück, das Erfolg oder Fehler angibt.

Bemerkungen

Beispielcode-

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
    }
}

Anforderungen

Anforderung	Wert
Header-	dbgmodel.h

Siehe auch

IDebugHostSymbols-Schnittstelle