IDebugDataSpaces3::ReadTagged 메서드(dbgeng.h)

ReadTagged 메서드는 디버거 세션과 연결될 수 있는 태그가 지정된 데이터를 읽습니다.

구문

HRESULT ReadTagged(
  [in]            LPGUID Tag,
  [in]            ULONG  Offset,
  [out, optional] PVOID  Buffer,
  [in]            ULONG  BufferSize,
  [out, optional] PULONG TotalSize
);

매개 변수

[in] Tag

요청된 데이터를 식별하는 GUID를 지정합니다.

[in] Offset

읽을 데이터 내의 오프셋을 지정합니다.

[out, optional] Buffer

데이터를 받습니다. Buffer가 NULL이면 데이터가 반환되지 않습니다.

[in] BufferSize

버 퍼 버퍼의 크기(바이트)를 지정합니다. 반환될 최대 바이트 수입니다.

[out, optional] TotalSize

Tag에서 지정한 데이터의 총 크기(바이트)를 받습니다.

반환 값

반환 코드	Description
S_OK	메서드를 성공적으로 수행했습니다.
E_NOINTERFACE	태그로 식별된 데이터를 찾을 수 없습니다.

 

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

설명

일부 디버거 세션에는 임의의 추가 데이터를 사용할 수 있습니다. 예를 들어 덤프 파일을 만들 때 추가 정보가 포함된 추가 덤프 정보 파일도 생성될 수 있습니다. 이 추가 데이터는 전역 고유 식별자를 사용하여 태그가 지정되며 태그를 통해서만 검색할 수 있습니다.

LPGUID는 128비트 고유 식별자에 대한 포인터입니다. Microsoft Windows SDK 헤더 파일 guiddef.h에 정의되어 있습니다.

요구 사항

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

추가 정보

GetNextTagged

IDebugDataSpaces3

IDebugDataSpaces4