다음을 통해 공유

LoadLibrary 및 AfxLoadLibrary

  • 아티클

LoadLibrary 또는 LoadLibraryEx 호출을 처리하여 DLL에 명시적으로 연결합니다. (MFC 앱 사용 AfxLoadLibrary 또는 AfxLoadLibraryEx.) 함수가 성공하면 지정된 DLL을 호출 프로세스의 주소 공간에 매핑하고 DLL에 핸들을 반환합니다. 핸들은 명시적 링크에 사용되는 다른 함수(예: GetProcAddress 및 FreeLibrary)에 필요합니다. 자세한 내용은 명시적 연결을 참조하세요.

LoadLibrary는 암시적 연결에 사용되는 것과 동일한 검색 시퀀스를 사용하여 DLL의 위치를 찾으려고 시도합니다. LoadLibraryEx는 검색 경로 순서에 대한 더 많은 제어를 제공합니다. 자세한 내용은 동적 연결 라이브러리 순서(Windows)를 참조하세요. 시스템에서 DLL을 찾을 수 없거나 진입점 함수가 FALSE를 반환하는 경우 LoadLibrary는 NULL을 반환합니다. LoadLibrary에 대한 호출이 호출 프로세스의 주소 공간에 이미 매핑된 DLL 모듈을 지정하는 경우 함수는 DLL의 핸들을 반환하고 모듈의 참조 횟수를 증가시킵니다.

DLL에 진입점 함수가 있는 경우 운영 체제는 LoadLibrary 또는 LoadLibraryEx를 호출한 스레드의 컨텍스트에서 이 함수를 호출합니다. DLL이 프로세스에 이미 연결되어 있는 경우에는 진입점 함수가 호출되지 않습니다. DLL에 대한 LoadLibrary 또는 LoadLibraryEx에 대한 이전 호출에서 FreeLibrary 함수에 대해 상응하는 호출을 하지 않은 경우에 발생합니다.

MFC 확장 DLL을 로드하는 MFC 애플리케이션의 경우에는 LoadLibrary 또는 LoadLibraryEx 대신 AfxLoadLibrary 또는 AfxLoadLibraryEx를 사용하는 것이 좋습니다. MFC 함수는 DLL을 명시적으로 로드하기 전에 스레드 동기화를 처리합니다. AfxLoadLibrary 및 AfxLoadLibraryEx에 대한 인터페이스(함수 프로토타입)는 LoadLibrary 및 LoadLibraryEx와 동일합니다.

Windows에서 DLL을 로드할 수 없는 경우 프로세스에서 오류 복구를 시도할 수 있습니다. 예를 들어 사용자에게 오류를 알린 다음 DLL에 대한 다른 경로를 요청할 수 있습니다.

Important

모든 DLL의 전체 경로를 지정해야 합니다. LoadLibrary에서 파일을 로드할 때 먼저 현재 디렉터리를 검색할 수 있습니다. 파일의 경로를 완전히 정규화하지 않으면 의도한 파일이 아닌 파일이 로드될 수 있습니다. DLL을 만들 때 /DEPENDENTLOADFLAG 링커 옵션을 사용하여 정적으로 연결된 DLL 종속성의 검색 순서를 지정할 수 있습니다. DLL 내에서 전체 경로를 사용하여 종속성을 명시적으로 로드하고 LoadLibraryEx 또는 AfxLoadLibraryEx 호출 매개 변수를 사용하여 모듈 검색 순서를 지정합니다. 자세한 내용은 동적 연결 라이브러리 보안 및 동적 연결 라이브러리 검색 순서를 참조하세요.

수행할 작업

추가 정보

참고 항목