WindowsInspectString2 함수(winstring.h)

디버거가 다른 주소 공간, 원격 또는 덤프에서 Windows 런타임 HSTRING의 값을 표시하는 방법을 제공합니다.

구문

HRESULT WindowsInspectString2(
  UINT64                     targetHString,
  USHORT                     machine,
  PINSPECT_HSTRING_CALLBACK2 callback,
  void                       *context,
  UINT32                     *length,
  UINT64                     *targetStringAddress
);

매개 변수

targetHString

[in]

검사할 HSTRING 입니다.

machine

대상 주소 공간의 형식입니다. 유효한 값은 Win64, Win32의 IMAGE_FILE_MACHINE_I386 또는 32비트 ARM의 경우 IMAGE_FILE_MACHINE_ARM IMAGE_FILE_MACHINE_AMD64.

callback

[in]

대상 주소 공간에서 문자열 버퍼를 읽는 콜백 함수입니다. 이 함수는 길이 및 targetStringAddress 매개 변수가 WindowsInspectString2 함수에 의해 계산되기 전에 호출됩니다.

context

[in, optional]

콜백에 전달된 사용자 지정 컨텍스트 데이터입니다.

length

[out]

콜백 호출에 성공한 경우 대상 주소 공간의 문자열 길이입니다. 그렇지 않으면 0입니다.

targetStringAddress

[out]

콜백 호출에 성공한 경우 원시 PCWSTR의 대상 주소입니다. 그렇지 않으면 NULL입니다.

반환 값

이 함수는 이러한 값 중 하나를 반환할 수 있습니다.

반환 코드	설명
E_INVALIDARG	컴퓨터 값이 IMAGE_FILE_MACHINE_AMD64, IMAGE_FILE_MACHINE_I386 또는 IMAGE_FILE_MACHINE_ARM 또는 targetHString 이 올바르게 구성된 HSTRING이 아닙니다.

설명

WindowsInspectString 함수는 입력 및 출력 포인터를 네이티브 포인터 크기의 값으로 전달합니다. 현재 플랫폼이 Win32인 경우 해당 함수는 Win64인 프로세스에 대한 오류를 반환합니다.

WindowsInspectString2 를 사용하면 Win32 및 Win64 애플리케이션 모두에서 호출할 때 최대 64비트 값을 허용하여 아키텍처 간 디버깅을 수행할 수 있습니다.

요구 사항

지원되는 최소 클라이언트	Windows 8
지원되는 최소 서버	Windows Server 2012
대상 플랫폼	Windows
헤더	winstring.h
라이브러리	RuntimeObject.lib
DLL	ComBase.dll

추가 정보

HSTRING

PINSPECT_HSTRING_CALLBACK

WindowsCreateString

WindowsInspectString