IDebugSymbols3::StartSymbolMatch 메서드(dbgeng.h)

StartSymbolMatch 메서드는 이름이 지정된 패턴과 일치하는 기호에 대한 검색을 초기화합니다.

구문

HRESULT StartSymbolMatch(
  [in]  PCSTR    Pattern,
  [out] PULONG64 Handle
);

[in] Pattern

검색할 패턴을 지정합니다. 검색은 이름이 이 패턴과 일치하는 모든 기호를 반환합니다. 패턴 구문에 대한 자세한 내용은 기호 구문 및 기호 일치 및 문자열 와일드카드 구문을 참조하세요.

[out] Handle

검색을 식별하는 핸들을 받습니다. 이 핸들은 GetNextSymbolMatch 및 EndSymbolMatch에 전달할 수 있습니다.

이 메서드는 다른 오류 값을 반환할 수도 있습니다. 자세한 내용은 반환 값을 참조하세요.

반환 코드	Description
S_OK	메서드를 성공적으로 수행했습니다.
E_NOINTERFACE	지정한 모듈을 찾을 수 없습니다.

이 메서드는 기호 검색을 초기화합니다. GetNextSymbolMatch를 반복적으로 호출하여 검색 결과를 얻을 수 있습니다. 원하는 모든 결과가 발견되면 EndSymbolMatch 를 사용하여 엔진이 검색을 위해 보유하는 리소스를 해제합니다.

기호에 대한 자세한 내용은 기호를 참조하세요.

요구 사항	값
대상 플랫폼	데스크톱
머리글	dbgeng.h(Dbgeng.h 포함)