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

O método CreateModuleSignature cria uma assinatura que pode ser usada para corresponder a um conjunto de módulos específicos por nome e, opcionalmente, por versão. Há três componentes para uma assinatura de módulo:

• Um nome: um módulo correspondente deve ter um nome que não diferencia maiúsculas de minúsculas em relação ao nome na assinatura

• Uma versão mínima: se especificado, um módulo correspondente deve ter uma versão mínima que seja pelo menos tão alta quanto esta versão. As versões são especificadas no formato "A.B.C.D", com cada parte subsequente sendo menos importante do que a anterior. Somente o primeiro segmento é obrigatório.

• Uma versão máxima: se especificado, um módulo correspondente deve ter uma versão máxima que não seja superior a esta versão. As versões são especificadas no formato "A.B.C.D", com cada parte subsequente sendo menos importante do que a anterior. Somente o primeiro segmento é obrigatório.

Sintaxe

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

Parâmetros

pwszModuleName

O nome que um módulo deve ter para corresponder à assinatura (não diferencia maiúsculas de minúsculas).

pwszMinVersion

A versão mínima que um módulo deve ter para corresponder à assinatura. Se esse argumento for nullptr, não haverá nenhuma versão mínima necessária para corresponder à assinatura. As versões são especificadas como cadeias de caracteres no formato "A.B.C.D", com apenas o primeiro componente sendo necessário e os componentes subsequentes sendo menos importantes.

pwszMaxVersion

A versão máxima que um módulo pode ter para corresponder à assinatura. Se esse argumento for nullptr, não haverá nenhum limite superior no número de versão necessário para corresponder à assinatura. As versões são especificadas como cadeias de caracteres no formato "A.B.C.D", com apenas o primeiro componente sendo necessário e os componentes subsequentes sendo menos importantes.

ppModuleSignature

O objeto de assinatura de módulo criado é retornado aqui.

Retornar valor

Esse método retorna HRESULT que indica êxito ou falha.

Comentários

Código de exemplo

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

Requisitos

Requisito	Valor
Cabeçalho	dbgmodel.h

Confira também

Interface IDebugHostSymbols