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

ReadHandleData 메서드는 시스템 핸들로 지정된 시스템 개체에 대한 정보를 검색합니다.

구문

HRESULT ReadHandleData(
  [in]            ULONG64 Handle,
  [in]            ULONG   DataType,
  [out, optional] PVOID   Buffer,
  [in]            ULONG   BufferSize,
  [out, optional] PULONG  DataSize
);

매개 변수

[in] Handle

데이터가 요청된 개체의 시스템 핸들을 지정합니다. 시스템 핸들에 대한 자세한 내용은 핸들을 참조하세요.

[in] DataType

시스템 핸들에 대해 반환할 데이터 형식을 지정합니다. 다음 표에는 해당 반환 형식과 함께 유효한 값이 포함되어 있습니다.

값	Description
DEBUG_HANDLE_DATA_TYPE_BASIC	시스템 개체에 대한 기본 정보를 반환합니다. 이 경우 버퍼 인수는 형식이 PDEBUG_HANDLE_DATA_BASIC 것으로 간주될 수 있습니다.
DEBUG_HANDLE_DATA_TYPE_TYPE_NAME	개체 형식의 이름을 반환합니다. 예를 들어 "Process" 또는 "Thread"입니다. 이 경우 인수 버퍼 는 PSTR 형식으로 간주될 수 있습니다.
DEBUG_HANDLE_DATA_TYPE_OBJECT_NAME	개체의 이름을 반환합니다. 여기에는 개체 디렉터리의 위치가 포함됩니다. 이 경우 인수 버퍼 는 PSTR 형식으로 간주될 수 있습니다.
DEBUG_HANDLE_DATA_TYPE_HANDLE_COUNT	개체가 보유한 핸들 수를 반환합니다. 이는 필드 DEBUG_HANDLE_DATA_BASIC 비슷합니다. HandleCount. 이 경우 버퍼 인수는 PULONG 형식으로 간주될 수 있습니다.
DEBUG_HANDLE_DATA_TYPE_TYPE_NAME_WIDE	개체 형식의 이름을 반환합니다. 이 경우 인수 버퍼 는 PWSTR 형식으로 간주될 수 있습니다.
DEBUG_HANDLE_DATA_TYPE_OBJECT_NAME_WIDE	개체의 이름을 반환합니다. 이 경우 인수 버퍼 는 PWSTR 형식으로 간주될 수 있습니다.

[out, optional] Buffer

개체 데이터를 받습니다. 메서드가 성공적으로 완료되면 버퍼를 위의 표에 지정된 형식으로 캐스팅하여 이 버퍼 의 내용에 액세스할 수 있습니다.

Buffer가 NULL이면 이 정보가 반환되지 않습니다.

[in] BufferSize

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

[out, optional] DataSize

데이터의 크기를 바이트 단위로 받습니다. DataSize가 NULL이면 이 정보가 반환되지 않습니다.

반환 값

반환 코드	Description
S_OK	메서드를 성공적으로 수행했습니다.

 

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

설명

이 메서드는 사용자 모드 디버깅에서만 사용할 수 있습니다.

요구 사항

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

추가 정보

핸들

IDebugDataSpaces2

IDebugDataSpaces3

IDebugDataSpaces4