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"를 추가합니다.
그런데, "new IISVersionManagerLibrary."까지 해서 인텔리센스 창을 열어보자마자 실망하게 될 것입니다.
왜냐하면, 인스턴스화 할 수 있는 것이 단지 "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개의 인터페이스를 구하는 방법을 알아봤습니다.
일단은 마이크로소프트의 공식 문서 상으로 위와 같은 사용 설명서를 포함하고 있지 않지만 언젠가는 업데이트가 될 것입니다. 이 글은 그 때까지 유효하겠고. ^^
(
첨부된 문서는 위의 예제 코드를 담고 있습니다.)
[이 글에 대해서 여러분들과 의견을 공유하고 싶습니다. 틀리거나 미흡한 부분 또는 의문 사항이 있으시면 언제든 댓글 남겨주십시오.]