AddDllDirectory 함수(libloaderapi.h)

프로세스 DLL 검색 경로에 디렉터리를 추가합니다.

구문

DLL_DIRECTORY_COOKIE AddDllDirectory(
  [in] PCWSTR NewDirectory
);

매개 변수

[in] NewDirectory

검색 경로에 추가할 디렉터리의 절대 경로입니다. 예를 들어 디렉터리 Dir2를 프로세스 DLL 검색 경로에 추가하려면 \Dir2를 지정합니다. 경로에 대한 자세한 내용은 이름 지정 파일, 경로 및 네임스페이스를 참조하세요.

반환 값

함수가 성공하면 반환 값은 프로세스 DLL 검색 경로에서 DLL을 제거하기 위해 RemoveDllDirectory 에 전달할 수 있는 불투명 포인터입니다.

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

설명

AddDllDirectory 함수를 사용하여 DLL을 검색하는 디렉터리 집합에 절대 경로를 추가할 수 있습니다. SetDefaultDllDirectories가 먼저 LOAD_LIBRARY_SEARCH_USER_DIRS 호출되면 AddDllDirectory로 지정된 디렉터리가 프로세스 DLL 검색 경로에 추가됩니다. 그렇지 않으면 AddDllDirectory 함수로 지정된 디렉터리는 LOAD_LIBRARY_SEARCH_USER_DIRS 지정하는 LoadLibraryEx 함수 호출에만 사용됩니다.

AddDllDirectory를 사용하여 프로세스 DLL 검색 경로에 둘 이상의 디렉터리를 추가하는 경우 해당 디렉터리를 검색하는 순서는 지정되지 않습니다.

AddDllDirectory를 사용하여 추가된 디렉터리를 제거하려면 RemoveDllDirectory 함수를 사용합니다.

Windows 7, Windows Server 2008 R2, Windows Vista 및 Windows Server 2008: 애플리케이션에서 이 함수를 사용하려면 GetProcAddress 를 호출하여 Kernel32.dll 함수의 주소를 검색합니다. KB2533623 대상 플랫폼에 설치해야 합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 8 [데스크톱 앱만 해당],Windows 7, Windows Server 2008 R2, Windows Vista 및 Windows Server 2008에서 KB2533623
지원되는 최소 서버	Windows Server 2012 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	libloaderapi.h(Windows.h 포함)
DLL	Kernel32.dll