다음을 통해 공유

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

  • 아티클

GetNextSymbolMatchWide 메서드는 기호 검색에 있는 다음 기호를 반환합니다.

구문

HRESULT GetNextSymbolMatchWide(
  [in]            ULONG64  Handle,
  [out, optional] PWSTR    Buffer,
  [in]            ULONG    BufferSize,
  [out, optional] PULONG   MatchSize,
  [out, optional] PULONG64 Offset
);

매개 변수

[in] Handle

검색이 초기화될 때 StartSymbolMatch 에서 반환된 핸들을 지정합니다.

[out, optional] Buffer

기호의 이름을 받습니다. Buffer가 NULL이면 다음번에 이러한 메서드 중 하나가 호출될 때(동일한 핸들을 사용하여) 동일한 기호가 다시 반환됩니다. 기호 이름 크기를 결정하는 데 사용할 수 있습니다.

[in] BufferSize

버퍼의 문자 크기를 지정합니다. 이 크기에는 '\0' 종료 문자의 공간이 포함됩니다.

[out, optional] MatchSize

기호 이름의 문자로 크기를 받습니다. 이 크기에는 '\0' 종료 문자의 공간이 포함됩니다. MatchSize가 NULL이면 이 정보가 반환되지 않습니다.

[out, optional] Offset

기호의 대상 가상 주소 공간에서 위치를 받습니다. Offset이 NULL이면 이 정보가 반환되지 않습니다.

반환 값

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

반환 코드 Description
S_OK
 메서드를 성공적으로 수행했습니다.
S_FALSE
 버퍼의 크기가 기호 이름에 비해 너무 작거나 버퍼 가 NULL입니다.
E_NOINTERFACE
 패턴과 일치하는 기호가 더 이상 없습니다.

설명

먼저 StartSymbolMatch에서 검색을 초기화해야 합니다. 원하는 모든 기호가 발견되면 EndSymbolMatch 를 사용하여 엔진이 검색에 보유하는 리소스를 해제할 수 있습니다.

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

요구 사항

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

추가 정보

EndSymbolMatch

IDebugSymbols3

StartSymbolMatch