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] 버전 문자열의 길이에 대한 포인터입니다.

반환 값

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

비고

이 메서드는 GetRequestedRuntimeInfo 프로세스에 로드된 버전에 대한 런타임 정보를 반환하며, 컴퓨터에 설치된 최신 버전이 아닐 수 있습니다.

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

• 및 pwszVersionpConfigurationFile 매개 변수를 pExenull로 지정합니다.

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

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

• 특정 CLR 버전 로드를 지정하는 애플리케이션 구성 파일이 있습니다. 매개 변수에 null pConfigurationFile 을 지정하는 경우에도 .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 이후 사용 가능

참고하십시오

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