IDebugSymbols2::GetNextSymbolMatch 메서드(dbgeng.h)

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

구문

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

매개 변수

[in] Handle

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

[out, optional] Buffer

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

[in] BufferSize

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

[out, optional] MatchSize

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

[out, optional] Offset

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

반환 값

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

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

설명

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

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

요구 사항

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

추가 정보

EndSymbolMatch

IDebugSymbols

IDebugSymbols2

IDebugSymbols3

StartSymbolMatch