다음을 통해 공유

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 동작을 설명했습니다. 반환 값 목록을 추가했습니다. 사용되지 않는 메서드에 대한 얼터너티브를 추가했습니다.

콘텐츠 버그 수정