IDebugHostSymbols::CreateModuleSignature 메서드(dbgmodel.h)

CreateModuleSignature 메서드는 이름 및 필요에 따라 버전별로 특정 모듈 집합을 일치시키는 데 사용할 수 있는 서명을 만듭니다. 모듈 서명에는 다음 세 가지 구성 요소가 있습니다.

• 이름: 일치하는 모듈에는 서명의 이름과 정확히 대/소문자를 구분하지 않는 이름이 있어야 합니다.

• 최소 버전: 지정된 경우 일치하는 모듈에는 이 버전만큼 높은 최소 버전이 있어야 합니다. 버전은 "A.B.C.D" 형식으로 지정되며 각 후속 부분은 이전 부분보다 덜 중요합니다. 첫 번째 세그먼트만 필수입니다.

• 최대 버전: 지정된 경우 일치하는 모듈에는 이 버전보다 높지 않은 최대 버전이 있어야 합니다. 버전은 "A.B.C.D" 형식으로 지정되며 각 후속 부분은 이전 부분보다 덜 중요합니다. 첫 번째 세그먼트만 필수입니다.

구문

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

매개 변수

pwszModuleName

서명과 일치하기 위해 모듈에 있어야 하는 이름입니다(대/소문자를 구분하지 않음).

pwszMinVersion

서명과 일치하기 위해 모듈에 있어야 하는 최소 버전입니다. 이 인수가 nullptr이면 서명과 일치하는 최소 버전이 필요하지 않습니다. 버전은 첫 번째 구성 요소만 필요하고 후속 구성 요소가 덜 중요한 "A.B.C.D" 형식의 문자열로 지정됩니다.

pwszMaxVersion

서명과 일치하기 위해 모듈이 가질 수 있는 최대 버전입니다. 이 인수가 nullptr이면 서명과 일치하는 버전 번호에 대한 상한이 없습니다. 버전은 첫 번째 구성 요소만 필요하고 후속 구성 요소가 덜 중요한 "A.B.C.D" 형식의 문자열로 지정됩니다.

ppModuleSignature

생성된 모듈 서명 개체가 여기에 반환됩니다.

반환 값

이 메서드는 성공 또는 실패를 나타내는 HRESULT를 반환합니다.

설명

예제 코드

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

요구 사항

요구 사항	값
헤더	dbgmodel.h

추가 정보

IDebugHostSymbols 인터페이스