Porady: tworzenie wystąpień CComPtr i CComQIPtr i korzystanie z nich

W programowaniu klasyczny Windows, bibliotek często są implementowane jako obiekty COM (lub mówiąc ściślej, jako serwery COM).Wiele składników systemu operacyjnego Windows są implementowane jako serwery COM i bibliotek, w tym formularzu zapewniają wielu uczestników.Aby uzyskać informacje na temat podstaw COM, zobacz Component Object Model (COM).

Podczas wystąpienia obiektu hosta skryptów systemu Windows (COM, Component Object Model), przechowywać wskaźnika interfejsu w wskaźnika smart COM, który wykonuje Zliczanie przy użyciu wywołań do odwołań AddRef i Release w destruktor.Jeśli używasz Active Template Library (ATL) lub Microsoft Foundation Class biblioteki (MFC), a następnie użyć CComPtr inteligentnego wskaźnika.Jeśli nie używasz biblioteki ATL i MFC, a następnie użyć _com_ptr_t.Ponieważ nie COM jest równoważne z std::unique_ptr, użyj te wskaźniki smart dla scenariuszy jednego właściciela i wielu właścicieli.Obie CComPtr i ComQIPtr wsparcie przenoszenie operacji, których referencję.

Przykład

Poniższy przykład pokazuje, jak używać CComPtr do tworzenia wystąpienia obiektu COM i uzyskania wskaźników do swoich interfejsach.Należy zauważyć, że CComPtr::CoCreateInstance funkcji składowej jest używany do tworzenia obiektu COM, zamiast funkcji Win32, który ma taką samą nazwę.

void CComPtrDemo()
{

    HRESULT hr = CoInitialize(NULL);

    // Declare the smart pointer.
    CComPtr<IGraphBuilder> pGraph;

    // Use its member function CoCreateInstance to 
    // create the COM object and obtain the IGraphBuilder pointer.
    hr = pGraph.CoCreateInstance(CLSID_FilterGraph);
    if(FAILED(hr)){ /*... handle hr error*/ }

    // Use the overloaded -> operator to call the interface methods.
    hr = pGraph->RenderFile(L"C:\\Users\\Public\\Music\\Sample Music\\Sleep Away.mp3", NULL);
    if(FAILED(hr)){ /*... handle hr error*/ }

    // Declare a second smart pointer and use it to  
    // obtain another interface from the object.
    CComPtr<IMediaControl> pControl;
    hr = pGraph->QueryInterface(IID_PPV_ARGS(&pControl));
    if(FAILED(hr)){ /*... handle hr error*/ }

    // Obtain a third interface.
    CComPtr<IMediaEvent> pEvent;
    hr = pGraph->QueryInterface(IID_PPV_ARGS(&pEvent));
    if(FAILED(hr)){ /*... handle hr error*/ }

    // Use the second interface.
    hr = pControl->Run();
    if(FAILED(hr)){ /*... handle hr error*/ }

    // Use the third interface. 
    long evCode = 0;
    pEvent->WaitForCompletion(INFINITE, &evCode);

    CoUninitialize();

    // Let the smart pointers do all reference counting.
}

CComPtri jej krewnych są częścią ATL i są zdefiniowane w atlcomcli.h._com_ptr_tjest zadeklarowany w comip.h.Kompilator tworzy specjalizacje z _com_ptr_t Kiedy generuje klasy otoki dla biblioteki typów.

Zapewnia również ATL CComQIPtr, który ma prostsze składnię kwerenda obiektu COM pobrać dodatkowe interfejsu.Zaleca się jednak, CComPtr , ponieważ to nie wszystko, że CComQIPtr można zrobić i jest semantycznie bardziej spójne z surowego wskaźników interfejsów COM.Jeśli używasz CComPtr dla interfejsu kwerendy nowego wskaźnika interfejsu jest umieszczana w parametru wyjściowego.Jeśli wywołanie nie powiedzie się, zostanie zwrócona wartość HRESULT, co jest typowe wzór COM.Z CComQIPtr, wartość zwracana jest sam wskaźnik i jeśli wywołanie nie powiedzie się, zwracana wartość HRESULT wewnętrzne nie są dostępne.Dwa następne wiersze nie są wyświetlane jak błąd mechanizmów obsługi CComPtr i CComQIPtr różnią się.

// CComPtr with error handling:
CComPtr<IMediaControl> pControl;
hr = pGraph->QueryInterface(IID_PPV_ARGS(&pControl));
if(FAILED(hr)){ /*... handle hr error*/ }

// CComQIPtr with error handling
CComQIPtr<IMediaEvent> pEvent = pControl;
if(!pEvent){ /*... handle NULL pointer error*/ }

// Use the second interface.
hr = pControl->Run();
if(FAILED(hr)){ /*... handle hr error*/ }

CComPtrzapewnia specjalizacji IDispatch, która umożliwia wykorzystanie go do przechowywania wskaźniki do składników automatyzacji COM i wywoływać metody w interfejsie korzystając z późnym wiązaniem.CComDispatchDriverjest elementem TypeDef dla CComQIPtr<IDispatch, &IIDIDispatch>, który jest niejawnie konwertowane CComPtr<IDispatch>.W związku z tym, gdy zostanie wyświetlone dowolne z tych trzech nazw w kodzie, jest równoważne z CComPtr<IDispatch>.Poniższy przykład pokazuje, jak uzyskać wskaźnik do modelu obiektu programu Microsoft Word przy użyciu CComPtr<IDispatch>.

void COMAutomationSmartPointerDemo()
{

    CComPtr<IDispatch> pWord;
    CComQIPtr<IDispatch, &IID_IDispatch> pqi = pWord;
    CComDispatchDriver pDriver = pqi;

    HRESULT hr;
    _variant_t pOutVal;

    CoInitialize(NULL);
    hr = pWord.CoCreateInstance(L"Word.Application", NULL, CLSCTX_LOCAL_SERVER);    
    if(FAILED(hr)){ /*... handle hr error*/ }

    // Make Word visible.
    hr = pWord.PutPropertyByName(_bstr_t("Visible"),  &_variant_t(1));
    if(FAILED(hr)){ /*... handle hr error*/ }

    // Get the Documents collection and store it in new CComPtr
    hr = pWord.GetPropertyByName(_bstr_t("Documents"), &pOutVal);
    if(FAILED(hr)){ /*... handle hr error*/ }

    CComPtr<IDispatch> pDocuments = pOutVal.pdispVal; 

    // Use Documents to open a document
    hr = pDocuments.Invoke1 (_bstr_t("Open"), &_variant_t("c:\\users\\public\\documents\\sometext.txt"),&pOutVal);
    if(FAILED(hr)){ /*... handle hr error*/ }

    CoUninitialize();
}

Zobacz też

Koncepcje

Wskaźniki inteligentne (Modern C++)