Share via

Méthode IDebugHostSymbols ::CreateModuleSignature (dbgmodel.h)

  • Article

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. Une signature de module comporte trois composants :

  • Un 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

  • 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 la 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 la 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 (ne respectant pas la casse).

pwszMinVersion

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

ppModuleSignature

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

Valeur retournée

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

Configuration requise

Condition requise Valeur
En-tête dbgmodel.h

Voir aussi

Interface IDebugHostSymbols