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)
정성태

... 91  92  93  94  95  96  97  98  99  [100]  101  102  103  104  105  ...
NoWriterDateCnt.TitleFile(s)
11432정성태1/11/201826394.NET Framework: 726. WPF + Direct2D + SharpDX 출력 C# 예제파일 다운로드2
11431정성태1/11/201824364.NET Framework: 725. C# - 동기 방식이면서 비동기 메서드(awaitable)처럼 구현한 사례 [9]
11430정성태1/10/201827809.NET Framework: 724. WPF + Direct2D 출력 C# 예제 [2]파일 다운로드1
11429정성태1/9/201818518개발 환경 구성: 348. ASP.NET Core 2.1 Preview 버전 적용 방법
11428정성태1/6/201821284개발 환경 구성: 347. WinForm 프로젝트를 WPF 프로젝트 유형으로 변경하는 방법파일 다운로드1
11427정성태1/5/201819317오류 유형: 445. vcpkg 빌드 오류 - Starting the CLR failed with HRESULT 80040153
11426정성태1/5/201828981오류 유형: 444. curl로 호출할 때 발생하는 오류 정리
11425정성태1/4/201819619개발 환경 구성: 346. ASP.NET Core Web Application을 IIS에서 호스팅하는 방법 (2)
11424정성태1/4/201819174개발 환경 구성: 345. ASP.NET Core 프로젝트를 명령행에서 빌드하는 방법
11423정성태1/3/201837411VC++: 123. 내가 만든 코드보다 OpenCV의 속도가 월등히 빠른 이유 [8]파일 다운로드2
11422정성태1/2/201827968.NET Framework: 723. C# - OpenCvSharp 사용 시 C/C++을 이용한 속도 향상 (for 루프 연산) [4]파일 다운로드1
11421정성태1/2/201819770오류 유형: 443. Visual Studio - nuget configuration is invalid
11420정성태12/30/201723970.NET Framework: 722. C# - Windows 10 운영체제의 데스크톱 앱에서 음성인식(SpeechRecognizer) 사용하는 방법 [3]파일 다운로드1
11419정성태12/23/201726088.NET Framework: 721. WebClient 타입의 ...Async 메서드 호출은 왜 await + 동기 호출 시 hang 현상이 발생할까요? [2]파일 다운로드1
11418정성태12/23/201735861.NET Framework: 720. 비동기 메서드 내에서 await 시 ConfigureAwait 호출 의미 [2]파일 다운로드1
11417정성태12/22/201721707.NET Framework: 719. Task를 포함하는 async 메서드의 동작 방식 [2]
11416정성태12/21/201719358.NET Framework: 718. AsyncTaskMethodBuilder.Create() 메서드 동작 방식 [2]
11415정성태12/21/201721051.NET Framework: 717. Task를 포함하지 않는 async 메서드의 동작 방식 [6]
11414정성태12/21/201728228.NET Framework: 716. async 메서드의 void 반환 타입 사용에 대하여파일 다운로드2
11413정성태12/20/201722495개발 환경 구성: 344. 윈도우 10 - TTS 및 음성 인식을 위한 환경 설정
11412정성태12/20/201725187.NET Framework: 715. C# - Windows 10 운영체제의 데스크톱 앱에서 TTS(SpeechSynthesizer) 사용하는 방법 [1]파일 다운로드1
11411정성태12/20/201723422사물인터넷: 15. 라즈베리 파이용 C++ 프로젝트에 SSL Socket 적용
11410정성태12/20/201735710.NET Framework: 714. SSL Socket 예제 - C/C++ 서버, C# 클라이언트 [1]파일 다운로드1
11409정성태12/18/201741721VC++: 122. 오픈 소스 라이브러리를 쉽게 빌드해 주는 "C++ Package Manager for Windows: vcpkg" [7]
11408정성태12/18/201721339.NET Framework: 713. C# - SharpDX + DXGI를 이용한 윈도우 화면 캡처 소스 코드 + Direct2D 출력 + OpenCV (2)파일 다운로드1
11407정성태12/18/201724224.NET Framework: 712. C# - SharpDX + DXGI를 이용한 윈도우 화면 캡처 소스 코드 + Direct2D 출력 + OpenCV [1]파일 다운로드1
... 91  92  93  94  95  96  97  98  99  [100]  101  102  103  104  105  ...