WindowsInspectString 함수(winstring.h)

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

구문

HRESULT WindowsInspectString(
  UINT_PTR                  targetHString,
  USHORT                    machine,
  PINSPECT_HSTRING_CALLBACK callback,
  void                      *context,
  UINT32                    *length,
  UINT_PTR                  *targetStringAddress
);

매개 변수

targetHString

[in]

검사할 HSTRING 입니다.

machine

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

callback

[in]

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

context

[in, optional]

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

length

[out]

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

targetStringAddress

[out]

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

반환 값

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

반환 코드	설명
E_INVALIDARG	컴퓨터에 대해 IMAGE_FILE_MACHINE_AMD64 지정되었지만 현재 플랫폼은 Win64 또는 가 아닙니다. 컴퓨터 가 IMAGE_FILE_MACHINE_AMD64, IMAGE_FILE_MACHINE_I386 또는 IMAGE_FILE_MACHINE_ARM 또는 targetHString 이 올바르게 구성된 HSTRING이 아닙니다.

요구 사항

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

추가 정보

HSTRING

PINSPECT_HSTRING_CALLBACK

WindowsCreateString