WinAPI COM 객체의 CLSID, IID 완벽 정리와 인터페이스 구조 이해하기

🔑 CLSID와 IID의 차이점

COM 객체를 다룰 때 가장 먼저 접하게 되는 개념이 바로 CLSID와 IID입니다.
이 둘은 모두 GUID(Globally Unique Identifier)를 기반으로 하며, COM 환경에서 객체와 인터페이스를 식별하는 핵심 역할을 담당합니다.
하지만 용도는 명확히 다르기 때문에 정확히 구분하는 것이 중요합니다.

🆔 CLSID: COM 클래스(객체)를 식별하는 고유 ID

CLSID는 COM 클래스 객체를 식별하기 위한 고유한 식별자입니다.
즉, CLSID는 어떤 COM 객체를 생성할지 결정하는 ID로 이해할 수 있습니다.
이 값은 주로 CoCreateInstance 함수와 함께 사용되며, 객체 인스턴스를 만들 때 참조됩니다.

// 예시: CLSID 사용
CoCreateInstance(CLSID_SomeObject, nullptr, CLSCTX_INPROC_SERVER, IID_ISomeInterface, (void**)&pInterface);

🧩 IID: 인터페이스를 식별하는 고유 ID

IID는 특정 COM 인터페이스를 식별하는 고유 ID입니다.
COM은 인터페이스 기반 설계이기 때문에, QueryInterface를 통해 원하는 인터페이스 포인터를 요청할 때 반드시 IID가 필요합니다.
이 IID가 일치해야 해당 인터페이스의 포인터를 반환받을 수 있습니다.

예를 들어, IUnknown 인터페이스의 IID는 {00000000-0000-0000-C000-000000000046}로 고정되어 있으며, 모든 COM 객체가 이를 구현해야 합니다.
그 외의 사용자 정의 인터페이스는 개발자가 새로운 GUID를 생성하여 부여합니다.

🧱 COM 객체의 인터페이스 구조

COM은 모든 객체와의 상호작용을 인터페이스를 통해 수행합니다.
이 구조는 객체의 구현을 숨기고, 클라이언트는 오직 인터페이스를 통해 기능을 사용할 수 있도록 합니다.
이러한 설계는 캡슐화와 버전 호환성 측면에서 매우 유리한 구조입니다.

COM에서 모든 인터페이스는 IUnknown이라는 기본 인터페이스에서 파생됩니다.
IUnknown은 COM 객체의 기본 구조를 정의하는 세 가지 메서드를 포함합니다.

• 🔄QueryInterface – 인터페이스 간 형 변환
• ➕AddRef – 참조 카운트 증가
• ➖Release – 참조 카운트 감소 및 해제

🧬 인터페이스는 순수 가상 함수 집합

COM 인터페이스는 C++의 순수 가상 클래스로 정의됩니다.
이는 메서드 구현이 없고 오직 시그니처만 존재한다는 뜻입니다.
덕분에 다양한 구현체가 동일한 인터페이스를 공유할 수 있으며, 프로그램은 해당 구현에 구애받지 않고 인터페이스 기반으로 동작합니다.

// COM 인터페이스 정의 예시
interface IMyInterface : IUnknown {
    HRESULT MyMethod();
};

인터페이스 간의 관계는 다중 상속을 통해 확장될 수 있으며, 각 인터페이스는 고유한 IID를 갖습니다.
이런 구조 덕분에 COM은 유지보수가 쉽고 모듈화된 아키텍처를 제공합니다.

🌀 QueryInterface, AddRef, Release 이해하기

COM의 모든 객체는 IUnknown 인터페이스를 반드시 구현해야 하며, 이 인터페이스에는 세 가지 핵심 메서드가 정의되어 있습니다.
이들은 COM 객체의 생명주기 관리와 인터페이스 간 전환을 담당하며, COM 프로그래밍의 핵심입니다.

🔍 QueryInterface – 인터페이스 탐색

QueryInterface는 객체가 구현하고 있는 다른 인터페이스를 요청할 때 사용됩니다.
인자로 전달된 IID와 객체가 구현한 인터페이스를 비교하여 일치할 경우 해당 포인터를 반환합니다.

HRESULT QueryInterface(REFIID riid, void** ppvObject);

인터페이스가 존재하지 않으면 E_NOINTERFACE를 반환하며, 반드시 반환값을 확인한 후 사용해야 합니다.

➕ AddRef – 참조 카운트 증가

AddRef는 해당 객체에 대한 참조가 하나 더 생겼다는 것을 알립니다.
이 메서드는 내부적으로 참조 카운트를 1 증가시키며, 객체의 메모리를 유지시키는 역할을 합니다.

다중 컴포넌트나 클라이언트에서 같은 객체를 공유할 경우, 참조 카운트를 통해 메모리 누수를 방지할 수 있습니다.

➖ Release – 참조 카운트 감소 및 해제

Release는 현재 객체에 대한 참조가 더 이상 필요 없음을 알리는 메서드입니다.
이 호출은 참조 카운트를 1 감소시키며, 카운트가 0이 되는 순간 객체는 스스로 메모리에서 해제됩니다.

따라서 COM 객체를 사용할 때는 AddRef와 Release를 반드시 쌍으로 관리해야 안정적인 메모리 관리가 가능합니다.

🧩 COM 객체를 GUID로 식별하는 원리

COM의 핵심 구조 중 하나는 모든 객체와 인터페이스를 GUID로 식별한다는 점입니다.
이러한 구조 덕분에 다양한 컴포넌트 간의 충돌 없이, 전 세계 어디서든 유일하게 객체를 구분할 수 있습니다.
GUID는 128비트 값으로 구성되며, 마이크로소프트의 uuidgen 툴이나 Visual Studio에서 손쉽게 생성할 수 있습니다.

🧾 GUID 형식과 선언 방식

GUID는 다음과 같은 포맷으로 구성됩니다.
중괄호로 감싸고, 하이픈으로 나눈 8-4-4-4-12의 16진수 형식입니다.

// CLSID 및 IID 선언 예시
DEFINE_GUID(CLSID_SampleObject, 
0x12345678, 0x1234, 0x5678, 0xAB, 0xCD, 0xEF, 0x12, 0x34, 0x56, 0x78, 0x90);

COM에서 객체를 생성하거나 인터페이스를 요청할 때는 해당 GUID를 정확히 알고 있어야 하며, 이는 registry 또는 헤더 파일에 정의되어 있어야 합니다.

🌐 전역 고유성 보장

GUID는 전 세계적으로 충돌이 없도록 설계된 식별자입니다.
이로 인해, 수많은 개발자가 동시에 COM 컴포넌트를 만들어도 충돌 없이 독립적으로 동작할 수 있습니다.

윈도우 시스템 레지스트리에는 CLSID와 해당 DLL 경로가 등록되어 있어, 시스템은 CLSID를 기반으로 적절한 컴포넌트를 로드합니다.

🧪 예제 코드로 살펴보는 인터페이스 구현

이제 앞서 설명한 개념들을 바탕으로 실제 COM 인터페이스와 객체를 어떻게 구현하고 사용하는지를 코드로 살펴보겠습니다.
예제는 COM의 기본 구조에 해당하는 IUnknown 기반 인터페이스를 정의하고, 해당 인터페이스를 구현한 클래스를 만드는 방식으로 구성됩니다.

🧰 IExample 인터페이스 정의

// IExample 인터페이스 선언
interface IExample : public IUnknown {
    virtual void SayHello() = 0;
};

인터페이스에는 구현이 없으며, 순수 가상 함수만 존재합니다.
이 방식은 C++의 다형성과 동일한 원리로 동작합니다.

🛠️ CExample 클래스 구현

// CExample 클래스 정의
class CExample : public IExample {
private:
    ULONG refCount;
public:
    CExample() : refCount(1) {}
    
    // IUnknown 구현
    HRESULT QueryInterface(REFIID riid, void** ppvObject) {
        if (riid == IID_IUnknown || riid == __uuidof(IExample)) {
            *ppvObject = static_cast<IExample*>(this);
            AddRef();
            return S_OK;
        }
        *ppvObject = nullptr;
        return E_NOINTERFACE;
    }
    
    ULONG AddRef() {
        return ++refCount;
    }

    ULONG Release() {
        if (--refCount == 0) {
            delete this;
            return 0;
        }
        return refCount;
    }

    // IExample 구현
    void SayHello() {
        printf("Hello, COM World!\n");
    }
};

위 코드는 COM 객체에서의 참조 카운트 관리, QueryInterface 메서드 활용, 인터페이스 구현의 전형적인 구조를 보여줍니다.

❓ 자주 묻는 질문 (FAQ)