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

아티클
02/26/2024

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

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

[in] BufferSize

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

[out, optional] MatchSize

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

[out, optional] Offset

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

반환 값

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

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