LoadLibraryShim 함수

.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의 최신 버전입니다. 즉, szVersion이 null인 경우 버전 4보다 크거나 같은 모든 버전이 무시되고 버전 4보다 낮은 버전이 설치되지 않으면 DLL이 로드되지 않습니다. 이것은 .NET Framework 4 설치가 기존 애플리케이션 또는 구성 요소에 영향을 주지 않도록 하기 위한 것입니다. CLR 팀 블로그에서 In-Proc SxS 및 마이그레이션 빠른 시작 항목을 참조하세요.

pvReserved
다음에 사용하도록 예약됩니다.

phModDll
[out] 모듈의 핸들에 대한 포인터입니다.

Return Value

이 메서드는 다음 값 외에도 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의 함수가 이제 런타임에서 구현을 제공하는 래퍼이기 때문입니다.

요구 사항

플랫폼:시스템 요구 사항을 참조하세요.

헤더: MSCorEE.h

.NET Framework 버전: 1.0부터 사용 가능

참고 항목

• 사용되지 않는 CLR 호스팅 함수