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

... 46  47  48  49  50  [51]  52  53  54  55  56  57  58  59  60  ...
NoWriterDateCnt.TitleFile(s)
12696정성태7/6/202117403VC++: 146. 운영체제의 스레드 문맥 교환(Context Switch)을 유사하게 구현하는 방법파일 다운로드2
12695정성태7/3/202117585VC++: 145. C 언어의 setjmp/longjmp 기능을 Thread Context를 이용해 유사하게 구현하는 방법파일 다운로드1
12694정성태7/2/202119171Java: 24. Azure - Spring Boot 앱을 Java SE(Embedded Web Server)로 호스팅 시 로그 파일 남기는 방법 [1]
12693정성태6/30/202116180오류 유형: 731. Azure Web App Site Extension - Failed to install web app extension [...]. {1}
12692정성태6/30/202116844디버깅 기술: 180. Azure - Web App의 비정상 종료 시 남겨지는 로그 확인
12691정성태6/30/202116754개발 환경 구성: 573. 테스트 용도이지만 테스트에 적합하지 않은 Azure D1 공유(shared) 요금제
12690정성태6/28/202117636Java: 23. Azure - 자바(Java)로 만드는 Web App Service - Tomcat 호스팅
12689정성태6/25/202120015오류 유형: 730. Windows Forms 디자이너 - The class Form1 can be designed, but is not the first class in the file. [1]
12688정성태6/24/202119312.NET Framework: 1073. C# - JSON 역/직렬화 시 리플렉션 손실을 없애는 JsonSrcGen [2]파일 다운로드1
12687정성태6/22/202116442오류 유형: 729. Invalid data: Invalid artifact, java se app service only supports .jar artifact
12686정성태6/21/202117754Java: 22. Azure - 자바(Java)로 만드는 Web App Service - Java SE (Embedded Web Server) 호스팅
12685정성태6/21/202119815Java: 21. Azure Web App Service에 배포된 Java 프로세스의 메모리 및 힙(Heap) 덤프 뜨는 방법
12684정성태6/19/202118079오류 유형: 728. Visual Studio 2022부터 DTE.get_Properties 속성 접근 시 System.MissingMethodException 예외 발생
12683정성태6/18/202118775VS.NET IDE: 166. Visual Studio 2022 - Windows Forms 프로젝트의 x86 DLL 컨트롤이 Designer에서 오류가 발생하는 문제 [1]파일 다운로드1
12682정성태6/18/202115244VS.NET IDE: 165. Visual Studio 2022를 위한 Extension 마이그레이션
12681정성태6/18/202116122오류 유형: 727. .NET 2.0 ~ 3.5 + x64 환경에서 System.EnterpriseServices 참조 시 CS8012 경고
12680정성태6/18/202118166오류 유형: 726. python2.7.exe 실행 시 0xc000007b 오류
12679정성태6/18/202117868COM 개체 관련: 23. CoInitializeSecurity의 전역 설정을 재정의하는 CoSetProxyBlanket 함수 사용법파일 다운로드1
12678정성태6/17/202116118.NET Framework: 1072. C# - CoCreateInstance 관련 Inteop 오류 정리파일 다운로드1
12677정성태6/17/202119687VC++: 144. 역공학을 통한 lxssmanager.dll의 ILxssSession 사용법 분석파일 다운로드1
12676정성태6/16/202118483VC++: 143. ionescu007/lxss github repo에 공개된 lxssmanager.dll의 CLSID_LxssUserSession/IID_ILxssSession 사용법파일 다운로드1
12675정성태6/16/202116682Java: 20. maven package 명령어 결과물로 (war가 아닌) jar 생성 방법
12674정성태6/15/202117691VC++: 142. DEFINE_GUID 사용법
12673정성태6/15/202117880Java: 19. IntelliJ - 자바(Java)로 만드는 Web App을 Tomcat에서 실행하는 방법
12672정성태6/15/202120129오류 유형: 725. IntelliJ에서 Java webapp 실행 시 "Address localhost:1099 is already in use" 오류
12671정성태6/15/202129033오류 유형: 724. Tomcat 실행 시 Failed to initialize connector [Connector[HTTP/1.1-8080]] 오류
... 46  47  48  49  50  [51]  52  53  54  55  56  57  58  59  60  ...