4.4.1 __declspec(uuid()) 와 __uuidof()
__declspec 의 uuid 확장 속성을 사용하여 다음과 같이 COM 개체나 인터페이스에 GUID 를
지정할 수 있게 한다.
struct __declspec(uuid("60BB225D-A06F-11D1-9138-0020AF715AF0")) AddBack; struct __declspec(uuid("1AD1F491-A99C-11D1-9139-0020AF715AF0")) IAddEnd;
이와같이 __declspec(uuid())를 사용하여 지정된 GUID값을 꺼내오기 위해
Visual c++ 는 __uuidof 라는 예약어를 지원한다.
__uuidof 예약어는 다음과 같은 구문을 갖는다.
__uuidof(표현식)
_uuidof 예약어는 표현식에 지정된 클래스명이나 인터페이스명에대한 GUID값을
리턴해준다.
따라서 앞으로 __declspec(uuid()) 로 지정된 AddBack COM개체와 IAddEnd 인터페이스
의 GUID를 꺼내오기 위해 다음과 같이 __uuidof 예약어를 사용할 수 있다.
__uuidof(AddBack) __uuidof(IAddEnd)
4.4.2 __declspec(property) __declspec(property) 확장 속성은 클래스의'비정적 가상 데이터 멤버(non-static
virtual data member)'에 사용할 수 있다. 이 속성이 지정되고 이 변수에 포인터
멤버 선택 연산자('->')를 사용하여 참조할 때 컴파일러는 이들에 대하여
대응되는 함수 호출로 변경한다.
예를 들어, 다음과 같이 비정적 가상 데이터 멤버 AddEnd에 property 속성이
지정되었다고 하자.
__declspec(property(get=GetAddEnd, put=PutAddEnd)) short AddEnd;
위의 __declspec(property)확장 속성은 포인터 멤버 선택 연산자('->')와 함께 AddEnd
가 rvalue 로 사용될 때 get 함수로 지정된 GetAddEnd함수를 호출하고, AddEnd가
lvalue 로 사용될 때 put함수로 지정된 PubAddEnd 함수를 호출하게 한다.
따라서, 다음과 같이 AddEnd 데이터 멤버에서 값을 읽는 코드가 작성될 때,
m_nAddEnd = pIAddEnd->AddEnd;
Visual C++ 컴파일러는 다음과 같이 get 함수로 지정된 GetAddEnd함수를 호출한다.
m_nAddEnd = pIAddEnd->GetAddEnd();
마찬가지로, 다음과 같이 AddEnd데이터 멤버에 값을 지정하는 코드가 작성될때,
pIAddEnd->AddEnd = m_nAddEnd;
Visual C++ 컴파일러는 다음과 같이 put함수로 지정된 PubAddEnd 함수를 호출한다.
pIAddEnd->PutAddEnd( m_nAddEnd );
이때 주의 할 점은 다음과 같은 다중 대입 형식은 사용할수 없다는 것이다.
__declspec(property(get=GetSum, put=PutSum) ) short Sum;
m_pIAddEnd->AddEnd = m_pIAddEnd->Sum = 0;
위의 코드는 다음과 같이 해석되고,
m_pIAddEnd->PutAddEnd( m_pIAddEnd->PutSum(0) );
PutSum 함수는 void를 리턴하기 때문이다.
4.5 COM지원 클래스 4.5.1 _com_ptr_t 스마트 포인터 클래스
_com_ptr_t 클래스는 스마트 포인터(smart pointer) 기능을 갖고 있는
템플릿 클래스로,
COM 인터페이스 포인터를 캡슐화하여 COM개체의 새로운 인스턴스를 생성하는
CoCreateInstance 함수나
IUnknown 인터페이스의 레퍼런스 카운터를 관리하는
AddRef, Release 함수나
COM 개체가 제공하는 다른 인터페이스를 요청하는
QueryInterface 함수의 기능을 클래스 안에 감춤으로써 개발자들이 편리하게
인터페이스 포인터를 사용할수 있게 한다.
comip.h 헤더 파일에서 _com_ptr_t 템플릿 클래스가 구현된 코드를 볼수 있다.
_com_ptr_t 스카트 포인터 클래스는 _COM_SMARTPRT_TYPEDEF 매크로가
제공하는 typedef 문에 의해서 정의 된다.
이 매크로는 인터페이스 명과 IID를 매개 변수로 받아들여, 인터페이스 명뒤에 Ptr이
붙는 _com_ptr_t 클래스를 정의한다.
_COM_SMARTPRT_TYPEDEF(IAddEnd, __uuidof(IAddEnd));
위의 매크로는 다음과 같이 확장된다.
typedef _com_ptr_t< _com_IID<IAddEnd, __uuidof(IAddEnd)> > IAddEndPtr
따라서, 이제 IAddEnd 인터페이스가 IAddendPtr 스마트 포인터 클래스 안에 캡슐화됨으로써,
IAddEnd* 데이터형 대신에 IAddEndPtr 데이터형을 사용하여
IUnknown 인터페이스의 메서드를 사용하지 않고도 편리하게 IAddEnd인터페이스를 사용할수 있게 된다.
우리는 이제 ,
_COM_SMARTPRT_TYPEDEF 매크로가 생성한
_com_ptr_t 스마트 포인터 클래스를 사용하여 두가지 방법으로 COM개체의 새로운
인스턴스를 생성할 수 있다.
첫번째 방법은 _com_ptr_t 스마트 포인터 클래스의 인스턴스를 생성할때
생성자 매개변수에 CLSID나 ProgID를 지정하는 것이다. 이때 CLSID 를 구하기 위해
__uuidof 예약어를 함께 사용할수 있다.
struct __declspec(uuid("60bb225d-a06f-11d1-9138-0020af715af0")) AddBack;
IAddEndPtr pIAddEnd(__uuidof(AddBack));
또는
extern "C" const GUID __declspec(selectany) CLSID_AddBack =
{0x60BB225D,0xA06F,0x11D1,{0x91,0x38,0x00,0x20,0xAF,0x71,0x5A,0xF0}};
IAddEndPtr pIAddEnd(CLSID_AddBack);
또는
IAddEndPtr pIAddEnd("AddBack.AddBack.2");
이때 _com_ptr_t 스마트 포인터 클래스 생성자는 _com_ptr_t::CreateInstance 함수
를 호출하여 매개변수에 지정된 COM 개체의 새로운 인스턴스를 생성하게 된다.
두번째 방법은 _com_ptr_t 스마트 포인터 클래스의 디폴트 생성자를 사용하여
이 클래스의 개체를 생성한후, CLSID 나 ProgID 를 매개변로
_com_ptr_t::CreateInstance 함수를 호출하는 것이다.
HRESULT hr;
IAddEndPtr pIAddEnd;
hr = pIAddEnd.CreateInstance( __uuidof(AddBack) );
if (FAILED(hr) && (hr != E_NOINTERFACE)) {
...
}
또는,
hr = pIAddEnd.CreateInstance( CLSID_AddBack );
if (FAILED(hr) && (hr != E_NOINTERFACE)) {
...
}
또는,
hr = pIAddEnd.CreateInstance( "AddBack.AddBack.2" );
if (FAILED(hr) && (hr != E_NOINTERFACE)) {
...
}
_com_ptr_t::CreateInstance 멤버함수는 CoCreateInstance 함수를 호출하여
매개변수에 지정된 CLSID 또는 ProID 에 대응하는 COM 개체의 인스턴스를 생성한
후, QueryInterface 멤버 함수를 호출하여 해당 스마트 포인터 클래스가
캡슐화하는 인터페이스 포인터를 가져온다.
...................유의점.......................
_com_ptr_t 클래스의 멤버 함수에 접근할 때는 '.'멤버 접근 연산자를 사용하고,
생성된 COM개체의 속성 또는 메소드를 사용할 때는 '->' 멤버 접근 연산자를
사용한다는 점에 유의해야 한다.
pIAddEnd.CreateInstace(...); // _com_ptr_t 클래스의 멤버 함수 사용
pIAddEnd->AddEnd; // COM 개체의 속성사용
pIAddEnd->Add(); // COM 개체의 메서드
................................................
댓글
댓글 쓰기