Microsoft MVP성태의 닷넷 이야기
글쓴 사람
정성태 (techsharer at outlook.com)
홈페이지
첨부 파일
(연관된 글이 2개 있습니다.)
IIS Express - "IIS Installed Versions Manager Interface"의 IIISExpressProcessUtility 구하는 방법

IIS Express 관련해서 제어 방법을 찾아보니 다음의 글이 나왔습니다.

Starting and stopping IIS Express programmatically 
; http://stackoverflow.com/questions/4772092/starting-and-stopping-iis-express-programmatically

위의 글에서 질문한 사람은 "Version Manager API"를 "this purpose I want to use the official 'IIS Express API' which is documented on MSDN"이라고 하면서 '공식적인 방법'이라고 생각하고 있습니다. 하지만, 실제로 MSDN에서 보니 그렇지는 않더군요.

Version Manager API (IIS Express)
; https://learn.microsoft.com/en-us/iis/extensions/express-api-reference/version-manager-api-iis-express

분명히 다음과 같이 말하고 있습니다.

Note:
The IIS Version Manager API supports the IIS Express infrastructure and is not intended to be used directly from your code.


그래도 제어 방법이 그 이외에는 없는 한, 문서에서야 어찌되었건 MSDN에 나왔다는 것만으로 일단은 충분히 '공식적'이라고 여길 수밖에 없을 것 같습니다.




코딩을 해서 직접 구해 볼까요?

우선, C# 프로젝트에서 '참조 추가'를 통해 "IIS Installed Versions Manager Interface"를 추가합니다.

how_to_use_iisexpress_com_api_1.png

그런데, "new IISVersionManagerLibrary."까지 해서 인텔리센스 창을 열어보자마자 실망하게 될 것입니다.

how_to_use_iisexpress_com_api_3.png

왜냐하면, 인스턴스화 할 수 있는 것이 단지 "IISVersionManagerClass"밖에는 없기 때문입니다. IISExpressProcessUtility를 인스턴스화 할 수 있는 방법이 위에서는 제공되지 않습니다.

그나마 IISVersionManagerClass에서 제공되는 메서드 정보를 보면 다음과 같습니다.

[Guid("9CDA0717-2EB5-42B3-B5B0-16F4941B2029")]
[InterfaceType(1)]
public interface IIISVersionManager
{
    Array GetAllVersionObjects();
    IIISVersion GetVersionObject(string bstrVersion, IIS_PRODUCT_TYPE dwProductType);
}

그래도, 아주 희망이 없는 것은 아닌 것 같습니다. IIISVersion을 구할 수 있는 거 보면, 일단은 다음과 같이 시작해 볼 수 있습니다.

IISVersionManagerLibrary.IIISVersion ver 
    = mgr.GetVersionObject("7.5", IISVersionManagerLibrary.IIS_PRODUCT_TYPE.IIS_PRODUCT_EXPRESS);

IIISVersion 구조를 살펴 보니,

[Guid("1B036F99-B240-4116-A6A0-B54EC5B2438E")]
[InterfaceType(1)]
public interface IIISVersion
{
    void ApplyIISEnvironmentVariables();
    void ApplyManifestContext();
    void ClearIISEnvironmentVariables();
    void ClearManifestContext();
    object CreateObjectFromCLSID(Guid clsidObject);
    object CreateObjectFromProgId(string bstrObjectName);
    object GetPropertyValue(string bstrName);
}

IIISExpressProcessUtility를 구할 수 있는 메서드는 대략 다음과 같이 좁혀 듭니다.

  • CreateObjectFromCLSID
  • CreateObjectFromProgId
  • GetPropertyValue

헌데, COM 공부를 하신 분이라면 눈치채셨겠지만, IIISExpressProcessUtility 인터페이스는 ClassFactory가 없는 경우이므로 CLSID와 ProgId로부터는 개체를 생성할 수 없습니다. 이로써 남은 것은 GetPropertyValue 메서드인데, 문제는 수많은 문자열 중에 과연 어떤 것을 인자로 전달해야 우리가 원하는 것을 얻을 수 있냐는 것입니다.

역시 도움말을 찾아봐야겠지요. ^^

GetPropertyValue
; https://learn.microsoft.com/en-us/iis/extensions/express-api-reference/getpropertyvalue

위의 도움말에 보면, 다음과 같은 희망적인 문구가 나옵니다.

The set of valid property names can be obtained by calling the function with the name availableReadableProperties as the bstrName parameter, which returns a comma-delimited BSTR


이에 따라 실행해 보면,

object obj = ver.GetPropertyValue("availableReadableProperties");
Console.WriteLine(obj);

// 출력 결과

"version,productType,installPath,defaultConfigurationPath,defaultSchemaPath,manifestFile,userInstanceHelper,expressProcessHelper"


자, 이제 다시 감각을 따라야 할 시간입니다. 아무래도 가능성이 있어 보이는 것은 "expressProcessHelper" 같습니다.

object obj1 = ver.GetPropertyValue("expressProcessHelper");
IISVersionManagerLibrary.IIISExpressProcessUtility util 
    = obj1 as IISVersionManagerLibrary.IIISExpressProcessUtility;

과연 결과는? null이 아닙니다. 성공!




알아본 김에, userInstanceHelper 값이 어떤 인터페이스와 연관되었는지 결과를 보면,

object obj2 = ver.GetPropertyValue("userInstanceHelper");
IISVersionManagerLibrary.IIISUserData user 
    = obj2 as IISVersionManagerLibrary.IIISUserData;

역시 user 변수 값은 null이 아닙니다. 이로써, Version Manager API 문서에 기록된 IIISVersionManager, IIISVersion, IIISUserData, IIISExpressProcessUtility 총 4개의 인터페이스를 구하는 방법을 알아봤습니다.

일단은 마이크로소프트의 공식 문서 상으로 위와 같은 사용 설명서를 포함하고 있지 않지만 언젠가는 업데이트가 될 것입니다. 이 글은 그 때까지 유효하겠고. ^^

(첨부된 문서는 위의 예제 코드를 담고 있습니다.)



[이 글에 대해서 여러분들과 의견을 공유하고 싶습니다. 틀리거나 미흡한 부분 또는 의문 사항이 있으시면 언제든 댓글 남겨주십시오.]

[연관 글]






[최초 등록일: ]
[최종 수정일: 7/17/2023]

Creative Commons License
이 저작물은 크리에이티브 커먼즈 코리아 저작자표시-비영리-변경금지 2.0 대한민국 라이센스에 따라 이용하실 수 있습니다.
by SeongTae Jeong, mailto:techsharer at outlook.com

비밀번호

댓글 작성자
 



2011-05-02 01시43분
참고로, IIS Express는 현재 x86 버전만 제공되기 때문에 64비트 응용 프로그램에서 위의 COM 개체를 다루는 경우 다음과 같은 예외가 발생합니다.

System.Runtime.InteropServices.COMException (0x80040154): Retrieving the COM class factory for component with CLSID {B15183DD-75F9-42DF-8E57-C8B57692F134} failed due to the following error: 80040154 Class not registered (Exception from HRESULT: 0x80040154 (REGDB_E_CLASSNOTREG)).
at System.RuntimeTypeHandle.CreateInstance(RuntimeType type, Boolean publicOnly, Boolean noCheck, Boolean& canBeCached, RuntimeMethodHandleInternal& ctor, Boolean& bNeedSecurityCheck)
at System.RuntimeType.CreateInstanceSlow(Boolean publicOnly, Boolean skipCheckThis, Boolean fillCache)
at System.RuntimeType.CreateInstanceDefaultCtor(Boolean publicOnly, Boolean skipVisibilityChecks, Boolean skipCheckThis, Boolean fillCache)
at System.Activator.CreateInstance(Type type, Boolean nonPublic)
정성태

... 16  [17]  18  19  20  21  22  23  24  25  26  27  28  29  30  ...
NoWriterDateCnt.TitleFile(s)
13226정성태1/23/20234969.NET Framework: 2088. .NET 5부터 지원하는 GetRawSocketOption 사용 시 주의할 점
13225정성태1/21/20234141개발 환경 구성: 658. Windows에서 실행 중인 소켓 서버를 다른 PC 또는 WSL에서 접속할 수 없는 경우
13224정성태1/21/20234596Windows: 221. Windows - Private/Public/Domain이 아닌 네트워크 어댑터 단위로 방화벽을 on/off하는 방법
13223정성태1/20/20234756오류 유형: 838. RDP 연결 오류 - The two computers couldn't connect in the amount of time allotted
13222정성태1/20/20234420개발 환경 구성: 657. WSL - DockerDesktop.vhdx 파일 위치를 옮기는 방법
13221정성태1/19/20234629Linux: 57. C# - 리눅스 프로세스 메모리 정보파일 다운로드1
13220정성태1/19/20234705오류 유형: 837. NETSDK1045 The current .NET SDK does not support targeting .NET ...
13219정성태1/18/20234351Windows: 220. 네트워크의 인터넷 접속 가능 여부에 대한 판단 기준
13218정성태1/17/20234246VS.NET IDE: 178. Visual Studio 17.5 (Preview 2) - 포트 터널링을 이용한 웹 응용 프로그램의 외부 접근 허용
13217정성태1/13/20234836디버깅 기술: 185. windbg - 64비트 운영체제에서 작업 관리자로 뜬 32비트 프로세스의 덤프를 sos로 디버깅하는 방법
13216정성태1/12/20235084디버깅 기술: 184. windbg - 32비트 프로세스의 메모리 덤프인 경우 !peb 명령어로 나타나지 않는 환경 변수
13215정성태1/11/20236810Linux: 56. 리눅스 - /proc/pid/stat 정보를 이용해 프로세스의 CPU 사용량 구하는 방법 [1]
13214정성태1/10/20236140.NET Framework: 2087. .NET 6부터 SourceGenerator와 통합된 System.Text.Json [1]파일 다운로드1
13213정성태1/9/20235604오류 유형: 836. docker 이미지 빌드 시 "RUN apt install ..." 명령어가 실패하는 이유
13212정성태1/8/20235506기타: 85. 단정도/배정도 부동 소수점의 정밀도(Precision)에 따른 형변환 손실
13211정성태1/6/20235443웹: 42. (https가 아닌) http 다운로드를 막는 웹 브라우저
13210정성태1/5/20234592Windows: 219. 윈도우 x64의 경우 0x00000000`7ffe0000 아래의 주소는 왜 사용하지 않을까요?
13209정성태1/4/20234477Windows: 218. 왜 윈도우에서 가상 메모리 공간은 64KB 정렬이 된 걸까요?
13208정성태1/3/20234469.NET Framework: 2086. C# - Windows 운영체제의 2MB Large 페이지 크기 할당 방법파일 다운로드1
13207정성태12/26/20224751.NET Framework: 2085. C# - gpedit.msc의 "User Rights Assignment" 특권을 코드로 설정/해제하는 방법파일 다운로드1
13206정성태12/24/20224989.NET Framework: 2084. C# - GetTokenInformation으로 사용자 SID(Security identifiers) 구하는 방법 [3]파일 다운로드1
13205정성태12/24/20225225.NET Framework: 2083. C# - C++과의 연동을 위한 구조체의 fixed 배열 필드 사용 (2)파일 다운로드1
13204정성태12/22/20224674.NET Framework: 2082. C# - (LSA_UNICODE_STRING 예제로) CustomMarshaler 사용법파일 다운로드1
13203정성태12/22/20224847.NET Framework: 2081. C# Interop 예제 - (LSA_UNICODE_STRING 예제로) 구조체를 C++에 전달하는 방법파일 다운로드1
13202정성태12/21/20225240기타: 84. 직렬화로 설명하는 Little/Big Endian파일 다운로드1
13201정성태12/20/20225802오류 유형: 835. PyCharm 사용 시 C 드라이브 용량 부족
... 16  [17]  18  19  20  21  22  23  24  25  26  27  28  29  30  ...