동적 연결 라이브러리 검색 순서

동일한 DLL(동적 연결 라이브러리)의 여러 버전이 운영 체제(OS) 내의 다른 파일 시스템 위치에 존재하는 것이 일반적입니다. 전체 경로를 지정하여 지정된 DLL이 로드되는 특정 위치를 제어할 수 있습니다. 그러나 이 메서드를 사용하지 않는 경우 시스템은 이 항목에 설명된 대로 로드 시 DLL을 검색합니다. DLL 로더 DLL을 로드하거나 DLL에 대한 참조를 확인하는 운영 체제(OS)의 일부입니다.

팁

패키지된 및 패키지되지 않은 앱의 정의는 앱 패키징의장점과 단점을 참조하세요.

검색에 영향을 주는 요소

다음은 이 항목에서 설명하는 몇 가지 특별한 검색 요소입니다. DLL 검색 순서의 일부로 간주할 수 있습니다. 이 항목의 뒷부분에 나오는 섹션에는 다른 검색 위치와 함께 특정 앱 유형에 대한 적절한 검색 순서에 이러한 요소가 나열되어 있습니다. 이 섹션은 개념을 소개하고 항목의 뒷부분에서 참조하는 데 사용할 이름을 제공하기 위한 것입니다.

• DLL 리디렉션 . 자세한 내용은 동적 링크 라이브러리 리디렉션참조하세요.
• API는설정합니다. 자세한 내용은 windows API 집합 참조하세요.
• SxS(Side-by-Side) 매니페스트 리디렉션( 데스크톱 앱만(UWP 앱 아님) 애플리케이션 매니페스트(병렬 애플리케이션 매니페스트 또는 Fusion 매니페스트라고도 함)를 사용하여 리디렉션할 수 있습니다. 자세한 내용은 매니페스트참조하세요.
• 로드 모듈 목록 . 시스템에서 동일한 모듈 이름을 가진 DLL이 이미 메모리에 로드되었는지 확인할 수 있습니다(로드된 폴더에 관계없이).
• 알려진 DLL . DLL이 애플리케이션이 실행 중인 Windows 버전의 알려진 DLL 목록에 있는 경우 시스템은 알려진 DLL의 복사본(및 알려진 DLL의 종속 DLL(있는 경우)을 사용합니다. 현재 시스템에서 알려진 DLL 목록은 레지스트리 키 HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Session Manager\KnownDLLs참조하세요.

DLL에 종속성이 있는 경우 시스템은 모듈 이름만 사용하여 로드된 것처럼 종속 DLL을 검색합니다. 전체 경로를 지정하여 첫 번째 DLL을 로드한 경우에도 마찬가지입니다.

패키지된 앱에 대한 검색 순서

패키지된 앱이 LoadPackagedLibrary 함수를 호출하여 패키지된 모듈(특히 라이브러리 모듈- .dll 파일)을 로드하는 경우 DLL은 프로세스의 패키지 종속성 그래프에 있어야 합니다. 자세한 내용은 LoadPackagedLibrary참조하세요. 패키지된 앱이 다른 방법으로 모듈을 로드하고 전체 경로를 지정하지 않는 경우 시스템은 이 섹션에 설명된 대로 로드 시 DLL 및 해당 종속성을 검색합니다.

시스템에서 모듈 또는 해당 종속성을 검색할 때는 항상 패키지된 앱에 대한 검색 순서를 사용합니다. 종속성이 패키지된 앱 코드가 아닌 경우에도

패키지된 앱에 대한 표준 검색 순서

시스템은 다음 순서로 검색합니다.

1. DLL 리디렉션.
2. API 집합.
3. 데스크톱 앱만(UWP 앱 아님) . SxS 매니페스트 리디렉션.
4. 로드된 모듈 목록입니다.
5. 알려진 DLL입니다.
6. 프로세스의 패키지 종속성 그래프입니다. 애플리케이션의 패키지와 애플리케이션 패키지 매니페스트의 <Dependencies> 섹션에서 <PackageDependency> 지정된 모든 종속성입니다. 종속성은 매니페스트에 표시되는 순서대로 검색됩니다.
7. 호출 프로세스가 로드된 폴더(실행 파일의 폴더)입니다.
8. 시스템 폴더(%SystemRoot%\system32)입니다.

DLL에 종속성이 있는 경우 시스템은 모듈 이름만 사용하여 로드된 것처럼 종속 DLL을 검색합니다(첫 번째 DLL이 전체 경로를 지정하여 로드된 경우에도).

패키지된 앱에 대한 대체 검색 순서

모듈이 LOAD_WITH_ALTERED_SEARCH_PATHLoadLibraryEx 함수를 호출하여 표준 검색 순서를 변경하는 경우 검색 순서는 7단계에서 시스템이 실행 파일의 폴더 대신 지정된 모듈이 로드된 폴더(최상위 로딩 모듈의 폴더)에서 검색한다는 점을 제외하고 표준 검색 순서와 동일합니다.

패키지되지 않은 앱에 대한 검색 순서

패키지되지 않은 앱이 모듈을 로드하고 전체 경로를 지정하지 않으면 시스템은 이 섹션에 설명된 대로 로드 시 DLL을 검색합니다.

중요하다

공격자가 검색된 디렉터리 중 하나를 제어하는 경우 해당 폴더에 DLL의 악성 복사본을 배치할 수 있습니다. 이러한 공격을 방지하는 방법은 동적 링크 라이브러리 보안참조하세요.

패키지되지 않은 앱에 대한 표준 검색 순서

시스템에서 사용하는 표준 DLL 검색 순서는 안전한 DLL 검색 모드를 사용할 여부에 따라 달라집니다.

안전 DLL 검색 모드(기본적으로 사용하도록 설정됨)는 사용자의 현재 폴더를 검색 순서의 뒷부분으로 이동합니다. 안전한 DLL 검색 모드를 사용하지 않도록 설정하려면 HKEY_LOCAL_MACHINE\System\CurrentControlSet\Control\Session Manager\SafeDllSearchMode 레지스트리 값을 만들고 0으로 설정합니다. SetDllDirectory 함수를 호출하면 안전한 DLL 검색 모드(지정된 폴더가 검색 경로에 있는 동안)를 효과적으로 사용하지 않도록 설정하고 이 항목에 설명된 대로 검색 순서가 변경됩니다.

안전한 DLL 검색 모드를 사용하는 경우 검색 순서는 다음과 같습니다.

1. DLL 리디렉션.
2. API 집합.
3. SxS 매니페스트 리디렉션.
4. 로드된 모듈 목록입니다.
5. 알려진 DLL입니다.
6. Windows 11 버전 21H2(10.0; 빌드 22000) 이상에서. 프로세스의 패키지 종속성 그래프입니다. 애플리케이션의 패키지와 애플리케이션 패키지 매니페스트의 <Dependencies> 섹션에서 <PackageDependency> 지정된 모든 종속성입니다. 종속성은 매니페스트에 표시되는 순서대로 검색됩니다.
7. 애플리케이션이 로드된 폴더입니다.
8. 시스템 폴더입니다. GetSystemDirectory 함수를 사용하여 이 폴더의 경로를 검색합니다.
9. 16비트 시스템 폴더입니다. 이 폴더의 경로를 가져오는 함수는 없지만 검색됩니다.
10. Windows 폴더입니다. GetWindowsDirectory 함수를 사용하여 이 폴더의 경로를 가져옵니다.
11. 현재 폴더입니다.
12. PATH 환경 변수에 나열된 디렉터리입니다. 여기에는 App Paths 레지스트리 키로 지정된 애플리케이션별 경로가 포함되지 않습니다. 앱 경로 키는 DLL 검색 경로를 계산할 때 사용되지 않습니다.

안전한 DLL 검색 모드가 사용하지 않도록경우 현재 폴더 순서가 11에서 8 위치로 이동한다는 점을 제외하고 검색 순서는 동일합니다(7단계 직후). 애플리케이션이)를 로드한 폴더입니다.

패키지되지 않은 앱에 대한 대체 검색 순서

시스템에서 사용하는 표준 검색 순서를 변경하려면 LOAD_WITH_ALTERED_SEARCH_PATH사용하여 LoadLibraryEx 함수를 호출할 수 있습니다. SetDllDirectory 함수를 호출하여 표준 검색 순서를 변경할 수도 있습니다.

메모

또한 프로세스의 표준 검색 순서는 현재 프로세스가 시작되기 전에 부모 프로세스에서 SetDllDirectory 함수를 호출하여 영향을 받습니다.

대체 검색 전략을 지정하면 연결된 모든 실행 모듈이 배치될 때까지 해당 동작이 계속됩니다. 시스템이 DLL 초기화 루틴 처리를 시작하면 시스템은 표준 검색 전략으로 되돌아갑니다.

LoadLibraryEx 함수는 호출이 LOAD_WITH_ALTERED_SEARCH_PATH지정하고 lpFileName 매개 변수가 절대 경로를 지정하는 경우 대체 검색 순서를 지원합니다.

• 표준 검색 전략은 호출 애플리케이션의 폴더에서 (초기 단계 이후) 시작됩니다.
• LOAD_WITH_ALTERED_SEARCH_PATHLoadLibraryEx 지정한 대체 검색 전략은 LoadLibraryEx 로드할 실행 모듈 폴더에서 시작됩니다(초기 단계 이후).

이것이 그들이 다른 유일한 방법입니다.

안전한 DLL 검색 모드를 사용하는 경우 대체 검색 순서는 다음과 같습니다.

1-6단계는 표준 검색 순서와 동일합니다.

7. lpFileName 지정한 폴더입니다.
8. 시스템 폴더입니다. GetSystemDirectory 함수를 사용하여 이 폴더의 경로를 검색합니다.
9. 16비트 시스템 폴더입니다. 이 폴더의 경로를 가져오는 함수는 없지만 검색됩니다.
10. Windows 폴더입니다. GetWindowsDirectory 함수를 사용하여 이 폴더의 경로를 가져옵니다.
11. 현재 폴더입니다.
12. PATH 환경 변수에 나열된 디렉터리입니다. 여기에는 App Paths 레지스트리 키로 지정된 애플리케이션별 경로가 포함되지 않습니다. 앱 경로 키는 DLL 검색 경로를 계산할 때 사용되지 않습니다.

안전한 DLL 검색 모드가 사용하지 않도록 설정된 경우 현재 폴더 순서에서 위치 11에서 8 위치로 이동한다는 점을 제외하고 대체 검색 순서는 동일합니다(7단계 직후). lpFileName)로 지정된 폴더입니다.

SetDllDirectory 함수는 lpPathName 매개 변수가 경로를 지정하는 경우 대체 검색 순서를 지원합니다. 대체 검색 순서는 다음과 같습니다.

1-6단계는 표준 검색 순서와 동일합니다.

7. 애플리케이션이 로드된 폴더입니다.
8. SetDllDirectorylpPathName 매개 변수로 지정된 폴더입니다.
9. 시스템 폴더입니다.
10. 16비트 시스템 폴더입니다.
11. Windows 폴더입니다.
12. PATH 환경 변수에 나열된 디렉터리입니다.

lpPathName 매개 변수가 빈 문자열인 경우 호출은 검색 순서에서 현재 폴더를 제거합니다.

SetDllDirectory 지정된 폴더가 검색 경로에 있는 동안 안전한 DLL 검색 모드를 효과적으로 사용하지 않도록 설정합니다. SafeDllSearchMode 레지스트리 값을 기반으로 안전한 DLL 검색 모드를 복원하고 현재 폴더를 검색 순서로 복원하려면 lpPathName NULL로 SetDllDirectory 호출합니다.

LOAD_LIBRARY_SEARCH 플래그를 사용하여 순서 검색

LoadLibraryEx 함수와 함께 하나 이상의 LOAD_LIBRARY_SEARCH 플래그를 사용하여 검색 순서를 지정할 수 있습니다. SetDefaultDllDirectories 함수와 함께 LOAD_LIBRARY_SEARCH 플래그를 사용하여 프로세스에 대한 DLL 검색 순서를 설정할 수도 있습니다. AddDllDirectory 또는 SetDllDirectory함수를사용하여 프로세스 DLL 검색 순서에 대한 추가 디렉터리를 지정할 수 있습니다.

검색되는 디렉터리는 SetDefaultDllDirectories 또는 LoadLibraryEx지정한 플래그에 따라 달라집니다. 둘 이상의 플래그를 사용하는 경우 해당 디렉터리를 다음 순서대로 검색합니다.

1. LOAD_LIBRARY_SEARCH_DLL_LOAD_DIR. DLL이 포함된 폴더가 검색됩니다. 이 폴더는 로드할 DLL의 종속성에 대해서만 검색됩니다.
2. LOAD_LIBRARY_SEARCH_APPLICATION_DIR. 애플리케이션 폴더가 검색됩니다.
3. LOAD_LIBRARY_SEARCH_USER_DIRS. AddDllDirectory 함수 또는 SetDllDirectory 함수와 함께 명시적으로 추가된 경로가 검색됩니다. 둘 이상의 경로를 추가하면 경로를 검색하는 순서가 지정되지 않습니다.
4. LOAD_LIBRARY_SEARCH_SYSTEM32. 시스템 폴더가 검색됩니다.

LOAD_LIBRARY_SEARCH 플래그 없이 LoadLibraryEx 호출하거나 프로세스에 대한 DLL 검색 순서를 설정하는 경우 시스템은 표준 검색 순서 또는 대체 검색 순서를 사용하여 DLL을 검색합니다.

관련 항목

• 애플리케이션 등록
• 동적 링크 라이브러리 리디렉션
• 동적 링크 라이브러리 보안
• 병렬 구성 요소
• AddDllDirectory
• LoadLibrary
• LoadLibraryEx
• LoadPackagedLibrary
• SetDefaultDllDirectories
• SetDllDirectory