Criar componentes COM com C++/WinRT

Artigo
07/13/2023

O C++/WinRT pode ajudá-lo a criar componentes COM (Component Object Model) clássicos (ou coclasses), exatamente como ajuda a criar classes no Windows Runtime. Este tópico mostra como fazer isso.

Como C++/WinRT se comporta, por padrão, em relação a interfaces COM

O modelo winrt::implements de C++/WinRT é a base da qual suas classes de runtime e as fábricas de ativação derivam direta ou indiretamente.

Por padrão, winrt::implements ignora silenciosamente interfaces COM clássicas. Qualquer chamada de QueryInterface (QI) para interfaces COM clássicas, consequentemente, falharão com E_NOINTERFACE. Por padrão, winrt::implements dá suporte apenas a interfaces C++/WinRT.

winrt::IUnknown é uma interface C++/WinRT, portanto winrt::implements dá suporte para interfaces baseadas em winrt::IUnknown.
winrt::implements não dá suporte a ::IUnknown em si, por padrão.

Em alguns instantes, você verá como resolver os casos que não têm suporte por padrão. Mas primeiro, aqui está um exemplo de código para ilustrar o que acontece por padrão.

// Sample.idl
namespace MyProject 
{
    runtimeclass Sample
    {
        Sample();
        void DoWork();
    }
}

// Sample.h
#include "pch.h"
#include <shobjidl.h> // Needed only for this file.

namespace winrt::MyProject::implementation
{
    struct Sample : implements<Sample, IInitializeWithWindow>
    {
        IFACEMETHOD(Initialize)(HWND hwnd);
        void DoWork();
    }
}

E este é o código do cliente para consumir a classe Sample.

// Client.cpp
Sample sample; // Construct a Sample object via its projection.

// This next line doesn't compile yet.
sample.as<IInitializeWithWindow>()->Initialize(hwnd);

Habilitando o suporte COM clássico

A boa notícia é que, para fazer com que winrt::implements dê suporte a interfaces COM clássicas, basta incluir o arquivo de cabeçalho unknwn.h antes de incluir qualquer cabeçalho de C++/WinRT.

Você pode fazer isso explicitamente ou indiretamente incluindo alguns outros arquivos de cabeçalho, como ole2.h. Um método recomendado é incluir o arquivo de cabeçalho wil\cppwinrt.h, que faz parte das Bibliotecas de Implementação do Windows (WIL). O arquivo de cabeçalho wil\cppwinrt.h não apenas garante que unknwn.h seja incluído antes de winrt/base.h, ele também configura tudo de forma que C++/WinRT e WIL entendem as exceções e os códigos de erro um do outro.

Então você pode usar as<> para interfaces COM clássicas e o código do exemplo acima será compilado.

Observação

No exemplo acima, mesmo após habilitar o suporte COM clássico no cliente (o código que consome a classe), se você ainda não tiver habilitado o suporte COM clássico no servidor (o código que implementa a classe), então a chamada de as<> no cliente falhará porque o QI para o IInitializeWithWindow não funcionará.

Uma classe local (não projetada)

Uma classe local é aquela que é implementada e consumida na mesma unidade de compilação (aplicativo ou em outro binário); e, portanto, não há projeção para ela.

Aqui está um exemplo de uma classe local que implementa apenas interfaces COM clássicas.

struct LocalObject :
    winrt::implements<LocalObject, IInitializeWithWindow>
{
    ...
};

Se você implementar esse exemplo, mas não habilitar o suporte COM clássico, o código a seguir falhará.

winrt::make<LocalObject>(); // error: ‘first_interface’: is not a member of ‘winrt::impl::interface_list<>’

Novamente, o IInitializeWithWindow não será reconhecido como uma interface COM, portanto, ele será ignorado pelo C++/WinRT. No caso do exemplo LocalObject, o resultado de ignorar as interfaces COM significa que o LocalObject não tem nenhuma interface. Mas toda classe COM deve implementar pelo menos uma interface.

Um exemplo simples de um componente COM

Este é um exemplo simples de um componente COM escrito usando C++/WinRT. Esta é uma lista completa de um miniaplicativo, de modo que você pode experimentar o código colando-o em pch.h e em main.cpp de um novo projeto do Aplicativo de Console do Windows (C++/WinRT).

// pch.h
#pragma once
#include <unknwn.h>
#include <winrt/Windows.Foundation.h>

// main.cpp : Defines the entry point for the console application.
#include "pch.h"

struct __declspec(uuid("ddc36e02-18ac-47c4-ae17-d420eece2281")) IMyComInterface : ::IUnknown
{
    virtual HRESULT __stdcall Call() = 0;
};

using namespace winrt;
using namespace Windows::Foundation;

int main()
{
    winrt::init_apartment();

    struct MyCoclass : winrt::implements<MyCoclass, IPersist, IStringable, IMyComInterface>
    {
        HRESULT __stdcall Call() noexcept override
        {
            return S_OK;
        }

        HRESULT __stdcall GetClassID(CLSID* id) noexcept override
        {
            *id = IID_IPersist; // Doesn't matter what we return, for this example.
            return S_OK;
        }

        winrt::hstring ToString()
        {
            return L"MyCoclass as a string";
        }
    };

    auto mycoclass_instance{ winrt::make<MyCoclass>() };
    CLSID id{};
    winrt::check_hresult(mycoclass_instance->GetClassID(&id));
    winrt::check_hresult(mycoclass_instance.as<IMyComInterface>()->Call());
}

Confira também Consumir componentes COM com C++/WinRT.

Um exemplo mais realista e interessante

O restante deste tópico orienta sobre a criação de um projeto de aplicativo de console mínimo que usa C++/WinRT para implementar uma coclasse básica (componente COM ou classe COM) e a fábrica de classes. O aplicativo de exemplo mostra como fornecer uma notificação do sistema com um botão de retorno de chamada e a coclasse (que implementa a interface COM INotificationActivationCallback) permite ao aplicativo iniciar e retornar a chamada quando o usuário clica nesse botão na notificação do sistema.

Para saber mais sobre a área do recurso de notificação do sistema, acesse Enviar uma notificação do sistema local. Nenhum dos exemplos de código nesta seção da documentação usa o C++/WinRT, então recomendamos dar preferência ao código mostrado neste tópico.

Criar um projeto de Aplicativo de Console do Windows (ToastAndCallback)

Comece criando um novo projeto no Microsoft Visual Studio. Crie um projeto Aplicativo de Console do Windows (C++/WinRT) chamado ToastAndCallback.

Abra pch.h e adicione #include <unknwn.h> antes de incluir qualquer cabeçalho C++/WinRT. Este é o resultado; é possível substituir o conteúdo do pch.h pela listagem.

// pch.h
#pragma once
#include <unknwn.h>
#include <winrt/Windows.Foundation.h>

Abra main.cpp e remova as diretivas de uso geradas pelo modelo do projeto. No lugar delas, insira o código a seguir (o que nos dá as bibliotecas, os cabeçalhos e os nomes de tipo que precisamos). Este é o resultado; é possível substituir o conteúdo de main.cpp por esta listagem (também removemos o código de main da listagem abaixo, porque substituiremos essa função posteriormente).

// main.cpp : Defines the entry point for the console application.

#include "pch.h"

#pragma comment(lib, "advapi32")
#pragma comment(lib, "ole32")
#pragma comment(lib, "shell32")

#include <iomanip>
#include <iostream>
#include <notificationactivationcallback.h>
#include <propkey.h>
#include <propvarutil.h>
#include <shlobj.h>
#include <winrt/Windows.UI.Notifications.h>
#include <winrt/Windows.Data.Xml.Dom.h>

using namespace winrt;
using namespace Windows::Data::Xml::Dom;
using namespace Windows::UI::Notifications;

int main() { }

O projeto ainda não será compilado; depois de terminar de adicionar o código, você será solicitado a compilar e executar.

Implementar a fábrica de classe e de coclasse

No C++/WinRT, implementa-se fábricas de classe e de coclasse, derivando do struct básico winrt::implements. Imediatamente após as três diretivas de uso mostradas acima (e antes de main), cole este código para implementar seu componente de ativador COM para a notificação do sistema.

static constexpr GUID callback_guid // BAF2FA85-E121-4CC9-A942-CE335B6F917F
{
    0xBAF2FA85, 0xE121, 0x4CC9, {0xA9, 0x42, 0xCE, 0x33, 0x5B, 0x6F, 0x91, 0x7F}
};

std::wstring const this_app_name{ L"ToastAndCallback" };

struct callback : winrt::implements<callback, INotificationActivationCallback>
{
    HRESULT __stdcall Activate(
        LPCWSTR app,
        LPCWSTR args,
        [[maybe_unused]] NOTIFICATION_USER_INPUT_DATA const* data,
        [[maybe_unused]] ULONG count) noexcept final
    {
        try
        {
            std::wcout << this_app_name << L" has been called back from a notification." << std::endl;
            std::wcout << L"Value of the 'app' parameter is '" << app << L"'." << std::endl;
            std::wcout << L"Value of the 'args' parameter is '" << args << L"'." << std::endl;
            return S_OK;
        }
        catch (...)
        {
            return winrt::to_hresult();
        }
    }
};

struct callback_factory : implements<callback_factory, IClassFactory>
{
    HRESULT __stdcall CreateInstance(
        IUnknown* outer,
        GUID const& iid,
        void** result) noexcept final
    {
        *result = nullptr;

        if (outer)
        {
            return CLASS_E_NOAGGREGATION;
        }

        return make<callback>()->QueryInterface(iid, result);
    }

    HRESULT __stdcall LockServer(BOOL) noexcept final
    {
        return S_OK;
    }
};

A implementação da coclasse acima segue o mesmo padrão demonstrado em Criar APIs com C++/WinRT. Portanto, você pode usar a mesma técnica para implementar interfaces COM e interfaces do Windows Runtime. Os componentes COM e as classes do Windows Runtime expõem seus recursos por meio de interfaces. Cada interface COM deriva da interface IUnknown. O Windows Runtime é baseado em COM, uma diferença é que as interfaces do Windows Runtime derivam da interface IInspectable (e IInspectable deriva de IUnknown).

Na coclasse do código acima, implementamos o método INotificationActivationCallback::Activate, que é a função chamada quando o usuário clica no botão de retorno de chamada em uma notificação do sistema. Porém, antes que essa função possa ser chamada, é preciso criar uma instância da coclasse e esse é o trabalho da função IClassFactory::CreateInstance.

A coclasse que implementamos apenas é conhecida como o ativador COM para notificações e tem uma ID de classe (CLSID) na forma do identificador callback_guid (do tipo GUID), que pode ser vista acima. Usaremos esse identificador mais tarde, na forma de um atalho do menu Iniciar e uma entrada do Registro do Windows. O ativador COM CLSID e o caminho para seu servidor COM associado (que é o caminho para o arquivo executável que estamos criando aqui) é o mecanismo pelo qual uma notificação do sistema sabe qual classe usar para criar uma instância quando o botão de retorno de chamada é clicado (independentemente de o clique ocorrer na Central de Ações ou não).

Práticas recomendadas para implementação de métodos COM

As técnicas para o tratamento de erros e para o gerenciamento de recursos podem andar de mãos dadas. É mais conveniente e prático usar exceções que códigos de erro. E se você implementar a linguagem resource-acquisition-is-initialization (RAII), será possível evitar a verificação explícita de códigos de erro e o lançamento explícito de recursos. Essas verificações explícitas tornam seu código mais complicado que o necessário, e fornecem muitos lugares para os bugs se esconderem. Em vez disso, use RAII e exceções throw/catch. Dessa forma, as suas alocações de recursos se tornam à prova de exceções e seu código fica simples.

No entanto, você não deve permitir que as exceções escapem das suas implementações de método COM. Você pode garantir o uso do especificador noexcept em seus métodos de COM. É possível lançar as exceções em qualquer lugar no gráfico de chamadas do método, desde que você os trate antes de sair do seu método. Se você usar noexcept, mas depois permitir que uma exceção escape do seu método, o aplicativo será encerrado.

Adicionar os tipos e funções auxiliares

Nesta etapa, vamos adicionar algumas funções e tipos auxiliares usados pelo restante do código. Portanto, imediatamente antes de main, adicione o seguinte.

struct prop_variant : PROPVARIANT
{
    prop_variant() noexcept : PROPVARIANT{}
    {
    }

    ~prop_variant() noexcept
    {
        clear();
    }

    void clear() noexcept
    {
        WINRT_VERIFY_(S_OK, ::PropVariantClear(this));
    }
};

struct registry_traits
{
    using type = HKEY;

    static void close(type value) noexcept
    {
        WINRT_VERIFY_(ERROR_SUCCESS, ::RegCloseKey(value));
    }

    static constexpr type invalid() noexcept
    {
        return nullptr;
    }
};

using registry_key = winrt::handle_type<registry_traits>;

std::wstring get_module_path()
{
    std::wstring path(100, L'?');
    uint32_t path_size{};
    DWORD actual_size{};

    do
    {
        path_size = static_cast<uint32_t>(path.size());
        actual_size = ::GetModuleFileName(nullptr, path.data(), path_size);

        if (actual_size + 1 > path_size)
        {
            path.resize(path_size * 2, L'?');
        }
    } while (actual_size + 1 > path_size);

    path.resize(actual_size);
    return path;
}

std::wstring get_shortcut_path()
{
    std::wstring format{ LR"(%ProgramData%\Microsoft\Windows\Start Menu\Programs\)" };
    format += (this_app_name + L".lnk");

    auto required{ ::ExpandEnvironmentStrings(format.c_str(), nullptr, 0) };
    std::wstring path(required - 1, L'?');
    ::ExpandEnvironmentStrings(format.c_str(), path.data(), required);
    return path;
}

Implementar as funções restantes e a função de ponto de entrada wmain

Exclua a função main e, no lugar dela, cole esta listagem de códigos, que inclui um código para registrar sua coclasse e, em seguida, fornecer uma notificação de sistema capaz de retornar chamadas para seu aplicativo.

void register_callback()
{
    DWORD registration{};

    winrt::check_hresult(::CoRegisterClassObject(
        callback_guid,
        make<callback_factory>().get(),
        CLSCTX_LOCAL_SERVER,
        REGCLS_SINGLEUSE,
        &registration));
}

void create_shortcut()
{
    auto link{ winrt::create_instance<IShellLink>(CLSID_ShellLink) };
    std::wstring module_path{ get_module_path() };
    winrt::check_hresult(link->SetPath(module_path.c_str()));

    auto store = link.as<IPropertyStore>();
    prop_variant value;
    winrt::check_hresult(::InitPropVariantFromString(this_app_name.c_str(), &value));
    winrt::check_hresult(store->SetValue(PKEY_AppUserModel_ID, value));
    value.clear();
    winrt::check_hresult(::InitPropVariantFromCLSID(callback_guid, &value));
    winrt::check_hresult(store->SetValue(PKEY_AppUserModel_ToastActivatorCLSID, value));

    auto file{ store.as<IPersistFile>() };
    std::wstring shortcut_path{ get_shortcut_path() };
    winrt::check_hresult(file->Save(shortcut_path.c_str(), TRUE));

    std::wcout << L"In " << shortcut_path << L", created a shortcut to " << module_path << std::endl;
}

void update_registry()
{
    std::wstring key_path{ LR"(SOFTWARE\Classes\CLSID\{????????-????-????-????-????????????})" };
    ::StringFromGUID2(callback_guid, key_path.data() + 23, 39);
    key_path += LR"(\LocalServer32)";
    registry_key key;

    winrt::check_win32(::RegCreateKeyEx(
        HKEY_CURRENT_USER,
        key_path.c_str(),
        0,
        nullptr,
        0,
        KEY_WRITE,
        nullptr,
        key.put(),
        nullptr));
    ::RegDeleteValue(key.get(), nullptr);

    std::wstring path{ get_module_path() };

    winrt::check_win32(::RegSetValueEx(
        key.get(),
        nullptr,
        0,
        REG_SZ,
        reinterpret_cast<BYTE const*>(path.c_str()),
        static_cast<uint32_t>((path.size() + 1) * sizeof(wchar_t))));

    std::wcout << L"In " << key_path << L", registered local server at " << path << std::endl;
}

void create_toast()
{
    XmlDocument xml;

    std::wstring toastPayload
    {
        LR"(
<toast>
  <visual>
    <binding template='ToastGeneric'>
      <text>)"
    };
    toastPayload += this_app_name;
    toastPayload += LR"(
      </text>
    </binding>
  </visual>
  <actions>
    <action content='Call back )";
    toastPayload += this_app_name;
    toastPayload += LR"(
' arguments='the_args' activationKind='Foreground' />
  </actions>
</toast>)";
    xml.LoadXml(toastPayload);

    ToastNotification toast{ xml };
    ToastNotifier notifier{ ToastNotificationManager::CreateToastNotifier(this_app_name) };
    notifier.Show(toast);
    ::Sleep(50); // Give the callback chance to display.
}

void LaunchedNormally(HANDLE, INPUT_RECORD &, DWORD &);
void LaunchedFromNotification(HANDLE, INPUT_RECORD &, DWORD &);

int wmain(int argc, wchar_t * argv[], wchar_t * /* envp */[])
{
    winrt::init_apartment();

    register_callback();

    HANDLE consoleHandle{ ::GetStdHandle(STD_INPUT_HANDLE) };
    INPUT_RECORD buffer{};
    DWORD events{};
    ::FlushConsoleInputBuffer(consoleHandle);

    if (argc == 1)
    {
        LaunchedNormally(consoleHandle, buffer, events);
    }
    else if (argc == 2 && wcscmp(argv[1], L"-Embedding") == 0)
    {
        LaunchedFromNotification(consoleHandle, buffer, events);
    }
}

void LaunchedNormally(HANDLE consoleHandle, INPUT_RECORD & buffer, DWORD & events)
{
    try
    {
        bool runningAsAdmin{ ::IsUserAnAdmin() == TRUE };
        std::wcout << this_app_name << L" is running" << (runningAsAdmin ? L" (administrator)." : L" (NOT as administrator).") << std::endl;

        if (runningAsAdmin)
        {
            create_shortcut();
            update_registry();
        }

        std::wcout << std::endl << L"Press 'T' to display a toast notification (press any other key to exit)." << std::endl;

        ::ReadConsoleInput(consoleHandle, &buffer, 1, &events);
        if (towupper(buffer.Event.KeyEvent.uChar.UnicodeChar) == L'T')
        {
            create_toast();
        }
    }
    catch (winrt::hresult_error const& e)
    {
        std::wcout << L"Error: " << e.message().c_str() << L" (" << std::hex << std::showbase << std::setw(8) << static_cast<uint32_t>(e.code()) << L")" << std::endl;
    }
}

void LaunchedFromNotification(HANDLE consoleHandle, INPUT_RECORD & buffer, DWORD & events)
{
    ::Sleep(50); // Give the callback chance to display its message.
    std::wcout << std::endl << L"Press any key to exit." << std::endl;
    ::ReadConsoleInput(consoleHandle, &buffer, 1, &events);
}

Como testar o aplicativo de exemplo

Compile o aplicativo e execute-o pelo menos uma vez como um administrador para fazer com que o código de registro e de outras configurações sejam executados. Uma maneira de fazer isso é executar o Visual Studio como administrador e executar o aplicativo do Visual Studio. Clique com o botão direito do mouse no Visual Studio na barra de tarefas para exibir a lista de atalhos, clique com o botão direito do mouse no Visual Studio na lista de atalhos e clique em Executar como administrador. Concorde com o prompt e abra o projeto. Ao executar o aplicativo, é exibida uma mensagem indicando se o aplicativo está sendo executado como administrador. Caso não esteja, o registro e outras configurações não serão executados. Esse registro e outras configurações devem ser executados pelo menos uma vez para que o aplicativo funcione corretamente.

Se você não estiver executando o aplicativo como administrador, pressione "T" para fazer com que uma notificação do sistema seja exibida. Clique no botão Retornar chamada de ToastAndCallback diretamente na notificação do sistema exibida ou na Central de Ações e o aplicativo será iniciado, a coclasse será instanciada e o método INotificationActivationCallback::Activate será executado.

Servidor COM em processamento

O aplicativo de exemplo ToastAndCallback acima funciona como um servidor COM local (ou fora do processo). Isso é indicado pela chave LocalServer32 do Registro do Windows , usada para registrar a CLSID da sua coclasse. Um servidor COM local hospeda sua(s) coclasse(s) em um binário executável (um .exe).

Como alternativa (e o que é mais provável), opte por hospedar sua(s) coclasse(s) em uma biblioteca de vínculo dinâmico (uma .dll). Um servidor COM na forma de uma DLL é conhecido como um servidor COM em processamento e é indicado pelas CLSIDs que estão sendo registradas ao usar a chave InprocServer32 do Registro do Windows.

Criar um projeto de biblioteca de vínculo dinâmico (DLL)

Você pode começar a tarefa de criação de um servidor COM em processamento criando um novo projeto no Microsoft Visual Studio. Crie um projeto Visual C++>Área de Trabalho do Windows>Biblioteca de Vínculo Dinâmico (DLL) .

Para adicionar o suporte a C++/WinRT para o novo projeto, siga as etapas descritas em Modificar um projeto de aplicativo de Área de Trabalho do Windows para adicionar suporte ao C++/WinRT.

Implementar a coclasse, a fábrica de classes e as exportações de servidor em processamento

Abra dllmain.cpp e adicione a ele a listagem de códigos exibida abaixo.

Se você já tem uma DLL que implementa as classes do Windows Runtime para C++/WinRT, já tem a função DllCanUnloadNow mostrada abaixo. Se quiser adicionar coclasses à DLL, use a função DllGetClassObject.

Se você não tem um código da Biblioteca de Modelos C++ do Windows Runtime (WRL) com o qual deseja permanecer compatível, remova a WRL do código mostrado.

// dllmain.cpp

struct MyCoclass : winrt::implements<MyCoclass, IPersist>
{
    HRESULT STDMETHODCALLTYPE GetClassID(CLSID* id) noexcept override
    {
        *id = IID_IPersist; // Doesn't matter what we return, for this example.
        return S_OK;
    }
};

struct __declspec(uuid("85d6672d-0606-4389-a50a-356ce7bded09"))
    MyCoclassFactory : winrt::implements<MyCoclassFactory, IClassFactory>
{
    HRESULT STDMETHODCALLTYPE CreateInstance(IUnknown *pUnkOuter, REFIID riid, void **ppvObject) noexcept override
    {
        try
        {
            return winrt::make<MyCoclass>()->QueryInterface(riid, ppvObject);
        }
        catch (...)
        {
            return winrt::to_hresult();
        }
    }

    HRESULT STDMETHODCALLTYPE LockServer(BOOL fLock) noexcept override
    {
        // ...
        return S_OK;
    }

    // ...
};

HRESULT __stdcall DllCanUnloadNow()
{
#ifdef _WRL_MODULE_H_
    if (!::Microsoft::WRL::Module<::Microsoft::WRL::InProc>::GetModule().Terminate())
    {
        return S_FALSE;
    }
#endif

    if (winrt::get_module_lock())
    {
        return S_FALSE;
    }

    winrt::clear_factory_cache();
    return S_OK;
}

HRESULT __stdcall DllGetClassObject(GUID const& clsid, GUID const& iid, void** result)
{
    try
    {
        *result = nullptr;

        if (clsid == __uuidof(MyCoclassFactory))
        {
            return winrt::make<MyCoclassFactory>()->QueryInterface(iid, result);
        }

#ifdef _WRL_MODULE_H_
        return ::Microsoft::WRL::Module<::Microsoft::WRL::InProc>::GetModule().GetClassObject(clsid, iid, result);
#else
        return winrt::hresult_class_not_available().to_abi();
#endif
    }
    catch (...)
    {
        return winrt::to_hresult();
    }
}

Suporte para referências fracas

Confira também Referências fracas em C++/WinRT.

O C++/ WinRT (especificamente, o modelo de struct básico winrt::implements) implementa IWeakReferenceSource se seu tipo implementa IInspectable (ou qualquer interface derivada de IInspectable).

Por esse motivo IWeakReferenceSource e IWeakReference são projetados para tipos do Windows Runtime. Dessa forma, é possível ativar o suporte de referência fraca para sua coclasse simplesmente adicionando winrt::Windows::Foundation::IInspectable (ou uma interface derivada de IInspectable) à sua implementação.

struct MyCoclass : winrt::implements<MyCoclass, IMyComInterface, winrt::Windows::Foundation::IInspectable>
{
    //  ...
};

Implementar uma interface COM que deriva de outra

A derivação de interface é um recurso do COM clássico (que está ausente, intencionalmente, do Windows Runtime). Veja um exemplo de como é a interface de derivação.

IFileSystemBindData2 : public IFileSystemBindData { /* ... */  };

Se você está escrevendo uma classe que precisa implementar, por exemplo, IFileSystemBindData e IFileSystemBindData2, a primeira etapa na expressão é declarar que você implementa apenas a interface derivada, da forma a seguir.

// pch.h
#pragma once
#include <Shobjidl.h>
...

// main.cpp
...
struct MyFileSystemBindData :
    implements<MyFileSystemBindData,
    IFileSystemBindData2>
{
    // IFileSystemBindData
    IFACEMETHOD(SetFindData)(const WIN32_FIND_DATAW* pfd) override { /* ... */ return S_OK; };
    IFACEMETHOD(GetFindData)(WIN32_FIND_DATAW* pfd) override { /* ... */ return S_OK; };

    // IFileSystemBindData2
    IFACEMETHOD(SetFileID)(LARGE_INTEGER liFileID) override { /* ... */ return S_OK; };
    IFACEMETHOD(GetFileID)(LARGE_INTEGER* pliFileID) override { /* ... */ return S_OK; };
    IFACEMETHOD(SetJunctionCLSID)(REFCLSID clsid) override { /* ... */ return S_OK; };
    IFACEMETHOD(GetJunctionCLSID)(CLSID* pclsid) override { /* ... */ return S_OK; };
};
...
int main()
...

A próxima etapa é garantir que QueryInterface seja bem-sucedido quando ele é chamado (direta ou indiretamente) para IID_IFileSystemBindData (a interface base) em uma instância de MyFileSystemBindData. Faça isso fornecendo uma especialização para o modelo de função winrt::is_guid_of.

winrt::is_guid_of é variádico e, portanto, você pode fornecer a ele uma lista de interfaces. Veja como você fornecerá uma especialização para que uma verificação de IFileSystemBindData2 também inclua um teste para IFileSystemBindData.

// pch.h
...
namespace winrt
{
    template<>
    inline bool is_guid_of<IFileSystemBindData2>(guid const& id) noexcept
    {
        return is_guid_of<IFileSystemBindData2, IFileSystemBindData>(id);
    }
}

// main.cpp
...
int main()
{
    ...
    auto mfsbd{ winrt::make<MyFileSystemBindData>() };
    auto a{ mfsbd.as<IFileSystemBindData2>() }; // Would succeed even without the **is_guid_of** specialization.
    auto b{ mfsbd.as<IFileSystemBindData>() }; // Needs the **is_guid_of** specialization in order to succeed.
}

A especialização de winrt::is_guid_of deve ser idêntica em todos os arquivos no projeto e visível no ponto em que a interface é usada pelo modelo winrt::implements ou winrt::delegate. Normalmente, você a colocaria em um arquivo de cabeçalho comum.

Compartilhar via

Criar componentes COM com C++/WinRT

Como C++/WinRT se comporta, por padrão, em relação a interfaces COM

Habilitando o suporte COM clássico

Uma classe local (não projetada)

Um exemplo simples de um componente COM

Um exemplo mais realista e interessante

Criar um projeto de Aplicativo de Console do Windows (ToastAndCallback)

Implementar a fábrica de classe e de coclasse

Práticas recomendadas para implementação de métodos COM

Adicionar os tipos e funções auxiliares

Implementar as funções restantes e a função de ponto de entrada wmain

Como testar o aplicativo de exemplo

Servidor COM em processamento

Criar um projeto de biblioteca de vínculo dinâmico (DLL)

Implementar a coclasse, a fábrica de classes e as exportações de servidor em processamento

Suporte para referências fracas

Implementar uma interface COM que deriva de outra

APIs importantes

Comentários

Recursos adicionais

Compartilhar via

Criar componentes COM com C++/WinRT

Como C++/WinRT se comporta, por padrão, em relação a interfaces COM

Habilitando o suporte COM clássico

Uma classe local (não projetada)

Um exemplo simples de um componente COM

Um exemplo mais realista e interessante

Criar um projeto de Aplicativo de Console do Windows (ToastAndCallback)

Implementar a fábrica de classe e de coclasse

Práticas recomendadas para implementação de métodos COM

Adicionar os tipos e funções auxiliares

Implementar as funções restantes e a função de ponto de entrada wmain

Como testar o aplicativo de exemplo

Servidor COM em processamento

Criar um projeto de biblioteca de vínculo dinâmico (DLL)

Implementar a coclasse, a fábrica de classes e as exportações de servidor em processamento

Suporte para referências fracas

Implementar uma interface COM que deriva de outra

APIs importantes

Tópicos relacionados

Comentários

Recursos adicionais