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

아티클
02/06/2025

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

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

[in] BufferSize

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

[out, optional] MatchSize

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

[out, optional] Offset

기호의 대상 가상 주소 공간에 있는 위치를 받습니다. 오프셋 NULL 경우 이 정보가 반환되지 않습니다.

반환 값

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

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