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)
13374정성태6/20/202311235오류 유형: 866. 파이썬 - <class 'AttributeError'> module 'flask.json' has no attribute 'JSONEncoder'
13373정성태6/19/202313054오류 유형: 865. 파이썬 - pymssql 설치 관련 오류 정리
13372정성태6/15/202311726개발 환경 구성: 682. SQL Server TLS 통신을 위해 사용되는 키 길이 확인 방법
13371정성태6/15/202312292개발 환경 구성: 681. openssl - 인증서 버전(V1 / V3)
13370정성태6/14/202312678개발 환경 구성: 680. C# - Ubuntu + Microsoft.Data.SqlClient + SQL Server 2008 R2 연결 방법 - TLS 1.2 지원
13369정성태6/13/202311322개발 환경 구성: 679. PyCharm(을 비롯해 JetBrains에 속한 여타) IDE에서 내부 Window들의 탭이 없어진 경우
13368정성태6/13/202312502개발 환경 구성: 678. openssl로 생성한 인증서를 SQL Server의 암호화 인증서로 설정하는 방법
13367정성태6/10/202313866오류 유형: 864. openssl로 만든 pfx 인증서를 Windows Server 2016 이하에서 등록 시 "The password you entered is incorrect" 오류 발생
13366정성태6/10/202312864.NET Framework: 2128. C# - 윈도우 시스템에서 지원하는 암호화 목록(Cipher Suites) 나열파일 다운로드1
13365정성태6/8/202310862오류 유형: 863. MODIFY FILE encountered operating system error 112(failed to retrieve text for this error. Reason: 15105)
13364정성태6/8/202313820.NET Framework: 2127. C# - Ubuntu + Microsoft.Data.SqlClient + SQL Server 2008 R2 연결 방법 [1]
13363정성태6/7/202313065스크립트: 49. 파이썬 - "Transformers (신경망 언어모델 라이브러리) 강좌" - 1장 2절 코드 실행 결과
13362정성태6/1/202312305.NET Framework: 2126. C# - 서버 측의 요청 제어 (Microsoft.AspNetCore.RateLimiting)파일 다운로드1
13361정성태5/31/202312864오류 유형: 862. Facebook - ASP.NET/WebClient 사용 시 graph.facebook.com/me 호출에 대해 403 Forbidden 오류
13360정성태5/31/202311929오류 유형: 861. WSL/docker - failed to start shim: start failed: io.containerd.runc.v2: create new shim socket
13359정성태5/19/202312918오류 유형: 860. Docker Desktop - k8s 초기화 무한 반복한다면?
13358정성태5/17/202313145.NET Framework: 2125. C# - Semantic Kernel의 Semantic Memory 사용 예제 [1]파일 다운로드1
13357정성태5/16/202311981.NET Framework: 2124. C# - Semantic Kernel의 Planner 사용 예제파일 다운로드1
13356정성태5/15/202313907DDK: 10. Device Driver 테스트 설치 관련 오류 (Code 37, Code 31) 및 인증서 관련 정리
13355정성태5/12/202312358.NET Framework: 2123. C# - Semantic Kernel의 ChatGPT 대화 구현 [1]파일 다운로드1
13354정성태5/12/202314191.NET Framework: 2122. C# - "Use Unicode UTF-8 for worldwide language support" 설정을 한 경우, 한글 입력이 '\0' 문자로 처리
13352정성태5/12/202313270.NET Framework: 2121. C# - Semantic Kernel의 대화 문맥 유지파일 다운로드1
13351정성태5/11/202313738VS.NET IDE: 185. Visual Studio - 원격 Docker container 내에 실행 중인 응용 프로그램에 대한 디버깅 [1]
13350정성태5/11/202313199오류 유형: 859. Windows Date and Time - Unable to continue. You do not have permission to perform this task
13349정성태5/11/202313190.NET Framework: 2120. C# - Semantic Kernel의 Skill과 Function 사용 예제 [1]파일 다운로드1
13348정성태5/10/202314268.NET Framework: 2119. C# - Semantic Kernel의 "Basic Loading of the Kernel" 예제
... 16  17  18  19  20  21  22  23  [24]  25  26  27  28  29  30  ...