LoadLibraryShim 함수
업데이트: 2010년 8월
.NET Framework 재배포 가능 패키지에 포함된 DLL의 지정된 버전을 로드합니다.
.NET Framework 버전 4에서는 이 함수가 더 이상 사용되지 않습니다. ICLRRuntimeInfo::LoadLibrary 메서드를 대신 사용합니다.
HRESULT LoadLibraryShim (
[in] LPCWSTR szDllName,
[in] LPCWSTR szVersion,
LPVOID pvReserved,
[out] HMODULE *phModDll
);
매개 변수
szDllName
[in] .NET Framework 라이브러리에서 로드할 DLL의 이름을 나타내는 문자열이며 0으로 종료됩니다.szVersion
[in] 로드할 DLL의 버전을 나타내는 문자열이며 0으로 종료됩니다. szVersion이 Null이면 로드하는 데 선택한 버전은 버전 4 미만으로, 지정한 DLL의 최신 버전입니다. 즉, 버전 4 보다 크거나 같은 모든 버전은 szVersion이 Null인 경우 무시되며 버전 4 미만의 버전이 설치되지 않은 경우 DLL이 로드되지 않습니다. 이것은 .NET Framework 4를 설치할 경우 기존 응용 프로그램 또는 구성 요소에 영향을 미치지 않음을 보장하기 위한 것입니다. CLR 팀 블로그에서 In-Proc SxS and Migration Quick Start 항목을 참조하십시오.pvReserved
다음에 사용하도록 예약됩니다.phModDll
[out] 모듈 핸들에 대한 포인터입니다.
반환 값
이 메서드는 다음 값뿐만 아니라 WinError.h에 정의된 표준 COM(구성 요소 개체 모델) 오류 코드도 반환합니다.
반환 코드 |
설명 |
---|---|
S_OK |
메서드가 성공적으로 완료되었습니다. |
CLR_E_SHIM_RUNTIMELOAD |
szDllName을 로드하면 CLR(공용 언어 런타임)을 로드해야 하며 필수 CLR 버전은 로드할 수 없습니다. |
설명
이 함수는 .NET Framework 재배포 가능 패키지에 포함된 DLL을 로드하는 데 사용됩니다. 이 함수는 사용자가 생성한 DLL은 로드하지 않습니다.
참고 |
---|
.NET Framework 버전 2.0으로 시작하여 Fusion.dll을 로드하면 CLR이 로드됩니다.이유는 이제 Fusion.dll의 함수가 런타임에서 구현을 제공하는 래퍼이기 때문입니다. |
요구 사항
플랫폼: .NET Framework 시스템 요구 사항 참조
헤더: MSCorEE.h
.NET Framework 버전: 4, 3.5 SP1, 3.5, 3.0 SP1, 3.0, 2.0 SP1, 2.0, 1.1, 1.0
참고 항목
기타 리소스
.NET Framework 1.1 및 2.0 호스팅 전역 정적 함수
변경 기록
날짜 |
변경 내용 |
이유 |
---|---|---|
2010년 8월 |
.NET Framework 4 in-process side-by-side 동작을 설명했습니다. 반환 값 목록을 추가했습니다. 사용되지 않는 메서드에 대한 얼터너티브를 추가했습니다. |
콘텐츠 버그 수정 |