Share via


ImageLoad 함수(imagehlp.h)

로드된 DLL 목록을 유지 관리합니다.

구문

PLOADED_IMAGE IMAGEAPI ImageLoad(
  [in] PCSTR DllName,
  [in] PCSTR DllPath
);

매개 변수

[in] DllName

이미지의 이름입니다.

[in] DllPath

제공된 이름을 찾을 수 없는 경우 이미지를 찾는 데 사용되는 경로입니다. NULL을 사용하는 경우 SearchPath 함수에 명시된 검색 경로 규칙이 적용됩니다.

반환 값

함수가 성공하면 반환 값은 LOADED_IMAGE 구조체에 대한 포인터입니다.

함수가 실패하면 반환 값은 NULL입니다. 확장된 오류 정보를 검색하려면 GetLastError를 호출합니다.

설명

ImageLoad 함수는 로드된 DLL 목록을 유지하는 데 사용됩니다. 이미지가 이미 로드된 경우 이전 LOADED_IMAGE 반환됩니다. 그렇지 않으면 새 이미지가 목록에 추가됩니다.

LOADED_IMAGE 구조체는 ImageUnload 함수에서 할당을 취소해야 합니다.

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

요구 사항

   
지원되는 최소 클라이언트 Windows XP [데스크톱 앱만 해당]
지원되는 최소 서버 Windows Server 2003 [데스크톱 앱만 해당]
대상 플랫폼 Windows
헤더 imagehlp.h
라이브러리 Imagehlp.lib
DLL Imagehlp.dll

참고 항목

ImageHlp 함수

ImageUnload

LOADED_IMAGE