ImagehlpApiVersionEx 함수(dbghelp.h)

아티클
08/23/2023

애플리케이션에서 사용하는 라이브러리의 버전 정보를 수정합니다.

구문

LPAPI_VERSION IMAGEAPI ImagehlpApiVersionEx(
  [in] LPAPI_VERSION AppVersion
);

매개 변수

[in] AppVersion

애플리케이션에 대한 유효한 버전 정보를 포함하는 API_VERSION 구조체에 대한 포인터입니다.

반환 값

반환 값은 API_VERSION 구조체에 대한 포인터입니다.

설명

ImagehlpApiVersionEx 함수를 사용하여 애플리케이션이 빌드된 라이브러리의 버전을 나타냅니다. 라이브러리는 이 정보를 사용하여 호환성을 보장합니다. 예를 들어 커널 모드 콜백 스택 프레임을 탐색하는 것이 좋습니다(사용자 및 GDI는 커널 모드에 있음). ImagehlpApiVersionEx를 호출하여 수정 버전 멤버를 버전 4 이상으로 설정하는 경우 StackWalk64 함수는 콜백 스택 프레임을 통해 계속됩니다. 그렇지 않으면 수정 버전을 4 이전 버전으로 설정하면 커널 전환 시 StackWalk64 가 중지됩니다.

이 함수와 같은 모든 DbgHelp 함수는 단일 스레드입니다. 따라서 둘 이상의 스레드에서 이 함수로 호출하면 예기치 않은 동작이나 메모리 손상이 발생할 수 있습니다. 이를 방지하려면 둘 이상의 스레드에서 이 함수로의 모든 동시 호출을 동기화해야 합니다.