IDebugHostSymbols::CreateModuleSignature-Methode (dbgmodel.h)
Die CreateModuleSignature-Methode erstellt eine Signatur, die verwendet werden kann, um einen Satz bestimmter Module nach Name und optional nach Version abzugleichen. Es gibt drei Komponenten für eine Modulsignatur:
Ein Name: Ein übereinstimmende Modul muss einen Namen haben, bei dem die Groß-/Kleinschreibung nicht mit dem Namen in der Signatur übereinstimmt.
Mindestversion: Wenn angegeben, muss ein übereinstimmende Modul 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 ist als der vorherige. Nur das erste Segment ist obligatorisch.
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 ist als der vorherige. Nur das erste Segment ist obligatorisch.
Syntax
HRESULT CreateModuleSignature(
PCWSTR pwszModuleName,
PCWSTR pwszMinVersion,
PCWSTR pwszMaxVersion,
IDebugHostModuleSignature **ppModuleSignature
);
Parameter
pwszModuleName
Der Name, den ein Modul haben muss, um der Signatur zu entsprechen (ohne Beachtung der Groß-/Kleinschreibung).
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 "A.B.C.D"-Format angegeben, wobei nur die erste Komponente erforderlich ist und nachfolgende Komponenten weniger wichtig sind.
pwszMaxVersion
Die maximale Version, die ein Modul haben kann, um der Signatur zu entsprechen. Wenn dieses Argument nullptr ist, ist keine Obergrenze für die Versionsnummer erforderlich, um der Signatur zu entsprechen. Versionen werden als Zeichenfolgen im "A.B.C.D"-Format 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 auf Erfolg oder Fehler hinweist.
Hinweise
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 |