Metodo IDebugHostSymbols::CreateModuleSignature (dbgmodel.h)

Articolo
08/07/2023

Il metodo CreateModuleSignature crea una firma che può essere usata per trovare una corrispondenza con un set di moduli specifici in base al nome e, facoltativamente, in base alla versione. Esistono tre componenti per una firma del modulo:

Nome: un modulo corrispondente deve avere un nome che rappresenta una corrispondenza esatta senza distinzione tra maiuscole e minuscole rispetto al nome nella firma
Versione minima: se specificata, un modulo corrispondente deve avere una versione minima che sia almeno uguale a quella di questa versione. Le versioni vengono specificate nel formato "A.B.C.D" con ogni parte successiva meno importante rispetto a quella precedente. Solo il primo segmento è obbligatorio.
Versione massima: se specificata, un modulo corrispondente deve avere una versione massima che non è superiore a questa versione. Le versioni vengono specificate nel formato "A.B.C.D" con ogni parte successiva meno importante rispetto a quella precedente. Solo il primo segmento è obbligatorio.

Sintassi

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

Parametri

pwszModuleName

Nome che un modulo deve avere per trovare la corrispondenza con la firma (senza distinzione tra maiuscole e minuscole).

pwszMinVersion

La versione minima di un modulo deve corrispondere alla firma. Se questo argomento è nullptr, non è necessaria alcuna versione minima per la corrispondenza della firma. Le versioni vengono specificate come stringhe nel formato "A.B.C.D" con solo il primo componente richiesto e i componenti successivi sono meno importanti.

pwszMaxVersion

Versione massima che un modulo può avere per trovare la corrispondenza con la firma. Se questo argomento è nullptr, non è previsto alcun limite massimo per il numero di versione necessario per trovare la corrispondenza con la firma. Le versioni vengono specificate come stringhe nel formato "A.B.C.D" con solo il primo componente richiesto e i componenti successivi sono meno importanti.

ppModuleSignature

L'oggetto firma del modulo creato viene restituito qui.

Valore restituito

Questo metodo restituisce HRESULT che indica l'esito positivo o negativo.

Commenti

Codice di esempio

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

Requisiti

Requisito	Valore
Intestazione	dbgmodel.h

Vedi anche

Interfaccia IDebugHostSymbols

Condividi tramite