SetDllDirectoryA 함수(winbase.h)
애플리케이션의 DLL을 찾는 데 사용되는 검색 경로에 디렉터리를 추가합니다.
통사론
BOOL SetDllDirectoryA(
[in, optional] LPCSTR lpPathName
);
매개 변수
[in, optional] lpPathName
검색 경로에 추가할 디렉터리입니다. 이 매개 변수가 빈 문자열("")인 경우 호출은 기본 DLL 검색 순서에서 현재 디렉터리를 제거합니다. 이 매개 변수가 NULL이면 함수는 기본 검색 순서를 복원합니다.
반환 값
함수가 성공하면 반환 값은 0이 아닌 값입니다.
함수가 실패하면 반환 값은 0입니다. 확장 오류 정보를 얻으려면 GetLastError호출합니다.
발언
SetDllDirectory 함수는 LoadLibrary 및 LoadLibraryEx 함수에 대한 모든 후속 호출에 영향을 줍니다. 또한 지정된 디렉터리가 검색 경로에 있는 동안 안전한 DLL 검색 모드를 효과적으로 사용하지 않도록 설정합니다.
메모
패키지 또는 보호된 프로세스를 실행하지
SetDllDirectory
- 애플리케이션이 로드된 디렉터리입니다.
- lpPathName 매개 변수로 지정된 디렉터리입니다.
- 시스템 디렉터리입니다. GetSystemDirectory 함수를 사용하여 이 디렉터리의 경로를 가져옵니다. 이 디렉터리의 이름은 System32입니다.
- 16비트 시스템 디렉터리입니다. 이 디렉터리의 경로를 가져오는 함수는 없지만 검색됩니다. 이 디렉터리의 이름은 System입니다.
- Windows 디렉터리입니다. GetWindowsDirectory 함수를 사용하여 이 디렉터리의 경로를 가져옵니다.
- PATH 환경 변수에 나열된 디렉터리입니다.
이 함수를 사용하는 애플리케이션을 컴파일하려면 _WIN32_WINNT 0x0502 이상으로 정의합니다. 자세한 내용은 Windows 헤더사용하는
메모
winbase.h 헤더는 SETDllDirectory를 유니코드 전처리기 상수의 정의에 따라 이 함수의 ANSI 또는 유니코드 버전을 자동으로 선택하는 별칭으로 정의합니다. 인코딩 중립 별칭을 인코딩 중립이 아닌 코드와 혼합하면 컴파일 또는 런타임 오류가 발생하는 불일치가 발생할 수 있습니다. 자세한 내용은 함수 프로토타입대한
요구 사항
| 요구 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows Vista, WINDOWS XP SP1 [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2003 [데스크톱 앱만 해당] |
| 대상 플랫폼 | Windows |
| 헤더 | winbase.h(Windows.h 포함) |
| 라이브러리 | Kernel32.lib |
| DLL | Kernel32.dll |
참고 항목
AddDllDirectory
GetDllDirectory
GetSystemDirectory
GetWindowsDirectory
LoadLibrary
LoadLibraryEx