IDebugHostSymbols ::CreateModuleSignature, méthode (dbgmodel.h)

Article
02/06/2025

La méthode CreateModuleSignature crée une signature qui peut être utilisée pour faire correspondre un ensemble de modules spécifiques par nom et éventuellement, par version. Il existe trois composants à une signature de module :

Nom : un module correspondant doit avoir un nom qui est une correspondance exacte qui ne respecte pas la casse par rapport au nom dans la signature
Une version minimale : si elle est spécifiée, un module correspondant doit avoir une version minimale qui est au moins aussi élevée que cette version. Les versions sont spécifiées au format « A.B.C.D », chaque partie suivante étant moins importante que celle précédente. Seul le premier segment est obligatoire.
Version maximale : si elle est spécifiée, un module correspondant doit avoir une version maximale qui n’est pas supérieure à cette version. Les versions sont spécifiées au format « A.B.C.D », chaque partie suivante étant moins importante que celle précédente. Seul le premier segment est obligatoire.

Syntaxe

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

Paramètres

pwszModuleName

Nom qu’un module doit avoir pour correspondre à la signature (sans respect de la casse).

pwszMinVersion

Version minimale qu’un module doit avoir pour correspondre à la signature. Si cet argument est nullptr, il n’existe aucune version minimale requise pour correspondre à la signature. Les versions sont spécifiées sous forme de chaînes au format « A.B.C.D » avec uniquement le premier composant requis et les composants suivants étant moins importants.

pwszMaxVersion

Version maximale qu’un module peut avoir pour correspondre à la signature. Si cet argument est nullptr, il n’existe aucune limite supérieure sur le numéro de version requis pour correspondre à la signature. Les versions sont spécifiées sous forme de chaînes au format « A.B.C.D » avec uniquement le premier composant requis et les composants suivants étant moins importants.

ppModuleSignature

L’objet de signature de module créé est retourné ici.

Valeur de retour

Cette méthode retourne HRESULT qui indique la réussite ou l’échec.

Remarques

exemple de code

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

Exigences

Exigence	Valeur
d’en-tête	dbgmodel.h

Voir aussi

interface IDebugHostSymbols

Partager via