Как да използвам COM DLL с LoadLibrary в C++

Обикновено бихте използвали CoCreateInstance() за инстанциране на обект от COM DLL. Когато направите това, няма нужда първо да зареждате DLL и да получавате proc адреси, както бихте трябвало да направите с нормален DLL. Това е така, защото Windows "знае" за типовете, които COM DLL имплементира, в каква DLL са имплементирани и как да ги инстанцира. (Ако приемем, разбира се, че COM DLL е регистриран, което обикновено е).

Да предположим, че имате COM DLL с IDog интерфейса, който искате да използвате. В този случай,

dog.idl

interface IDog : IUnknown
{
  HRESULT Bark();
};

coclass Dog
{
  [default] Interface IDog;
};

myCode.cpp

IDog* piDog = 0;
CoCreateInstance(CLSID_DOG, 0,  CLSCTX_INPROC_SERVER, IID_IDOG,  &piDog); // windows will instantiate the IDog object and place the pointer to it in piDog
piDog->Bark();  // do stuff
piDog->Release();  // were done with it now
piDog = 0;  // no need to delete it -- COM objects generally delete themselves

Всички тези неща за управление на паметта обаче могат да станат доста груби и ATL предоставя интелигентни указатели, които правят задачата за инстанциране и управление на тези обекти малко по-лесна:

CComPtr<IDog> dog;
dog.CoCreateInstance(CLSID_DOG);
dog->Bark();

РЕДАКТИРАНЕ:

Когато казах по-горе това:

Windows „знае“ за типовете, които COM DLL имплементира [...и] в какви DLL са имплементирани

...наистина премълчах как точно Windows знае това. Не е магия, въпреки че в началото може да изглежда малко окултно.

COM библиотеките идват с библиотеки за типове, които изброяват интерфейсите и CoClasses, които библиотеката предоставя. Тази библиотека с типове е под формата на файл на вашия твърд диск -- много често тя е вградена директно в същата DLL или EXE като самата библиотека. Windows знае къде да намери Type Library и самата COM Library, като търси в системния регистър на Windows. Записите в регистъра казват на Windows къде на твърдия диск се намира DLL.

Когато извикате CoCreateInstance, Windows търси clsid в системния регистър на Windows, намира съответния DLL, зарежда го и изпълнява правилния код в DLL, който имплементира COM обекта.

Как тази информация влиза в системния регистър на Windows? Когато се инсталира COM DLL, той се регистрира. Това обикновено се прави чрез стартиране на regsvr32.exe, което от своя страна зарежда вашата DLL в паметта и извиква функция с име DllRegisterServer. Тази функция, внедрена във вашия COM сървър, добавя необходимата информация към регистъра. Ако използвате ATL или друга COM рамка, това вероятно се прави под капака, така че да не се налага да взаимодействате директно с регистъра. DllRegisterServer трябва да се извика само веднъж, по време на инсталиране.

Ако се опитате да извикате CoCreateInstance за COM обект, който все още не е регистриран чрез процеса regsvr32/DllRegisterServer, тогава CoCreateInstance ще се провали с грешка, която казва:

Класът не е регистриран

За щастие решението за това е просто да извикате regsvr32 на вашия COM сървър и след това да опитате отново.

По принцип трябва да предпочитате CoCreateInstance или CoGetClassObject вместо директен достъп до DllGetClassObject. Но ако имате работа с DLL, който не можете или не искате да регистрирате, тогава по-долу е описано (част от) какво правят тези функции зад кулисите.

При даден CLSID, DllGetClassObject ви позволява да получите обекта на класа, от който можете да създавате екземпляри (чрез интерфейса IClassFactory, ако си спомням правилно).

Обобщение на стъпките (измина известно време, откакто за последен път докоснах COM, така че извинете за очевидни грешки):

1. Извикайте DllGetClassObject(clsid, IID_IClassFactory, &cf), където clsid е CLSID, за който искате да получите обекта на класа, а cf разбира се е фабриката за класове.
2. Извикайте cf->CreateInstance(0, iid, &obj), където iid е IID на интерфейса, който искате да използвате, а obj разбира се е обектът.
3. ???
4. печалба!

(CoCreateInstance изпълнява стъпки 1 и 2. CoGetClassObject изпълнява стъпка 1. Бихте използвали CoGetClassObject, ако трябва да създадете много екземпляри от един и същи клас, така че стъпка 1 не трябва да се повтаря всеки път.)

Не използвате директно LoadLibrary() с COM библиотека. CoCreateInstance() ще извика тази функция, ако все още не е, и след това ще създаде ново копие на класа, който сте внедрили в библиотеката, в купчината и накрая ще ви върне необработен указател към този обект. Разбира се, той може да се провали по време на процеса и следователно някакъв механизъм за проверка на състоянието като HRESULT.

За по-лесно използване можете да мислите за COM библиотека като за обикновен DLL с 1) някаква предварително дефинирана функция за запис (главна), 2) трябва да извикате някаква предварително дефинирана функция като CoCreateInstance(), за да я въведете, и да приемете, че е като че защото трябва.

Ако библиотеката с типове е вградена в DLL, можете да я импортирате във вашия проект:

#import "whatever.dll"

Това автоматично ще генерира заглавни файлове, които се включват във вашия проект и ви позволяват да използвате експортираните обекти.

Ето малко код, показващ как да получите фабриката за класове и да я използвате за създаване на COM обект. Той използва структура, за да следи манипулатора на модула и указателя на функцията DllGetClassObject. Трябва да държите манипулатора на модула, докато приключите с COM обекта.

За да използвате тази функция, трябва да разпределите екземпляр на структурата ComModuleInfo и да зададете szDLL на името на DLL файл или пълното име на пътя. След това извикайте функцията с идентификатора на класа и идентификатора на интерфейса на COM обекта, който искате да получите от този DLL.

typedef struct {
   TCHAR   szDLL[MAX_PATH];
   HMODULE hModule;
   HRESULT (WINAPI *pfnGetFactory)(REFCLSID, REFIID, void**);
   } ComModuleInfo;

HRESULT CreateCOMObject(
   ComModuleInfo & mod,  // [in,out] 
   REFCLSID iidClass,    // [in] CLSID of the COM object to create
   REFIID iidInterface,  // [in] GUID of the interface to get
   LPVOID FAR* ppIface)  // [in] on success, interface to the COM object is returned
{
    HRESULT hr = S_OK;

    *ppIface = NULL; // in case we fail, make sure we return a null interface.

    // init the ComModuleInfo if this is the first time we have seen it.
    //
    if ( ! mod.pfnGetFactory)
    {     
       if ( ! mod.hModule)
       {
          mod.hModule = LoadLibrary(mod.szDLL);
          if ( ! mod.hModule)
             return HRESULT_FROM_WIN32(GetLastError());
       }
       mod.pfnGetFactory = (HRESULT (WINAPI *)(REFCLSID, REFIID, void**))GetProcAddress(mod.hModule, "DllGetClassObject");
       if ( ! mod.pfnGetFactory)
          return HRESULT_FROM_WIN32(GetLastError());
    }

    IClassFactory* pFactory = NULL;
    hr = mod.pfnGetFactory(iidClass, IID_IClassFactory, (void**)&pFactory);
    if (SUCCEEDED(hr))
    {
       hr = pFactory->CreateInstance(NULL, iidInterface, (void**)ppIface);
       pFactory->Release();
    }

    return hr;
}

Ако това е COM DLL, всичко, което трябва да направите, е да го добавите като препратка към вашия проект и след това можете да извикате функциите, които са в DLL.

Да, можете да използвате COM функциите на ниско ниво като DLLGetClassObject, но защо бихте го направили?