다음을 통해 공유

GetRequestedRuntimeInfo 함수

  • 아티클

애플리케이션에서 요청한 CLR(공용 언어 런타임)에 대한 버전 및 디렉터리 정보를 가져옵니다.

이 함수는 .NET Framework 4에서 더 이상 사용되지 않습니다.

구문

HRESULT GetRequestedRuntimeInfo (  
    [in]  LPCWSTR  pExe,
    [in]  LPCWSTR  pwszVersion,
    [in]  LPCWSTR  pConfigurationFile,
    [in]  DWORD    startupFlags,
    [in]  DWORD    runtimeInfoFlags,
    [out] LPWSTR   pDirectory,
    [in]  DWORD    dwDirectory,
    [out] DWORD   *dwDirectoryLength,
    [out] LPWSTR   pVersion,
    [in]  DWORD    cchBuffer,
    [out] DWORD   *dwlength  
);

매개 변수

pExe
[in] 애플리케이션의 이름입니다.

pwszVersion
[in] 런타임의 버전 번호를 지정하는 문자열입니다.

pConfigurationFile
[in] pExe와 연결된 구성 파일의 이름입니다.

startupFlags
[in] STARTUP_FLAGS 열거형 값 중 하나 이상입니다.

runtimeInfoFlags
[in] RUNTIME_INFO_FLAGS 열거형 값 중 하나 이상입니다.

pDirectory
[out] 성공적 완료 시 런타임에 대한 디렉터리 경로를 포함하는 버퍼입니다.

dwDirectory
[in] 디렉터리 버퍼의 길이입니다.

dwDirectoryLength
[out] 디렉터리 경로 문자열의 길이에 대한 포인터입니다.

pVersion
[out] 성공적인 완료 시 런타임의 버전 번호를 포함하는 버퍼입니다.

cchBuffer
[in] 버전 문자열 버퍼의 길이입니다.

dwlength
[out] 버전 문자열의 길이에 대한 포인터입니다.

Return Value

이 메서드는 다음 값 외에도 WinError.h에 정의된 표준 COM(구성 요소 개체 모델) 오류 코드를 반환합니다.

반환 코드 설명
S_OK 메서드가 완료되었습니다.
ERROR_INSUFFICIENT_BUFFER 디렉터리 버퍼가 디렉터리 경로를 저장할 만큼 크지 않습니다.

-또는-

버전 버퍼가 버전 문자열을 저장할 만큼 크지 않습니다.

설명

GetRequestedRuntimeInfo 메서드는 프로세스에 로드된 버전에 대한 런타임 정보를 반환하며, 반드시 컴퓨터에 설치된 최신 버전일 필요는 없습니다.

.NET Framework 버전 2.0에서는 다음과 같이 GetRequestedRuntimeInfo 메서드를 사용하여 설치된 최신 버전에 대한 정보를 얻을 수 있습니다.

  • pExe, pwszVersion 및 pConfigurationFile 매개 변수를 null로 지정합니다.

  • runtimeInfoFlags 매개 변수에 대한 RUNTIME_INFO_FLAGS 열거에서 RUNTIME_INFO_UPGRADE_VERSION 플래그를 지정합니다.

GetRequestedRuntimeInfo 메서드는 다음 상황에서 최신 CLR 버전을 반환하지 않습니다.

  • 특정 CLR 버전 로드를 지정하는 애플리케이션 구성 파일이 있습니다. pConfigurationFile 매개 변수에 null을 지정하더라도 .NET Framework는 구성 파일을 사용합니다.

  • CorBindToRuntimeEx 메서드가 이전 CLR 버전을 지정하여 호출되었습니다.

  • 이전 CLR 버전용으로 컴파일된 애플리케이션이 현재 실행 중입니다.

runtimeInfoFlags 매개 변수의 경우 한 번에 RUNTIME_INFO_FLAGS 열거형의 아키텍처 상수 중 하나만 지정할 수 있습니다.

  • RUNTIME_INFO_REQUEST_IA64

  • RUNTIME_INFO_REQUEST_AMD64

  • RUNTIME_INFO_REQUEST_X86

요구 사항

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

헤더: MSCorEE.h

라이브러리: MSCorEE.dll

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

참고 항목