GetRequestedRuntimeInfo 함수

아티클
08/09/2011

응용 프로그램에서 요청한 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(구성 요소 개체 모델) 오류 코드도 반환합니다.

반환 코드	설명
S_OK	메서드가 성공적으로 완료되었습니다.
ERROR_INSUFFICIENT_BUFFER	디렉터리 버퍼의 크기가 작아서 디렉터리 경로를 저장할 수 없습니다. -또는- 버전 버퍼의 크기가 작아서 버전 문자열을 저장할 수 없습니다.

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 버전을 로드하도록 지정된 응용 프로그램 구성 파일이 있는 경우. .NET Framework에서는 pConfigurationFile 매개 변수에 null을 지정한 경우에도 구성 파일이 사용됩니다.
이전 CLR 버전을 지정하는 CorBindToRuntimeEx 메서드가 호출된 경우
이전 버전의 CLR에 대해 컴파일된 응용 프로그램이 현재 실행 중인 경우

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