gecko-dev/ipc/mscom/AgileReference.h
Aaron Klotz 6f56f5201f Bug 1576925: Make AgileReference copyable; r=Jamie
Until now, AgileReference was not copyable because it could not handle the
copying of global interface table cookies. By moving the cookie into its own
reference counted object, we can enable copying on the AgileReference.

Differential Revision: https://phabricator.services.mozilla.com/D43616

--HG--
extra : moz-landing-system : lando
2019-08-28 15:05:32 +00:00

144 lines
3.9 KiB
C++

/* -*- Mode: C++; tab-width: 8; indent-tabs-mode: nil; c-basic-offset: 2 -*- */
/* vim: set ts=8 sts=2 et sw=2 tw=80: */
/* This Source Code Form is subject to the terms of the Mozilla Public
* License, v. 2.0. If a copy of the MPL was not distributed with this
* file, You can obtain one at http://mozilla.org/MPL/2.0/. */
#ifndef mozilla_mscom_AgileReference_h
#define mozilla_mscom_AgileReference_h
#include "mozilla/Attributes.h"
#include "mozilla/RefPtr.h"
#include "nsISupportsImpl.h"
#include <objidl.h>
namespace mozilla {
namespace mscom {
namespace detail {
class MOZ_HEAP_CLASS GlobalInterfaceTableCookie final {
public:
GlobalInterfaceTableCookie(IUnknown* aObject, REFIID aIid,
HRESULT& aOutHResult);
bool IsValid() const { return !!mCookie; }
HRESULT GetInterface(REFIID aIid, void** aOutInterface) const;
NS_INLINE_DECL_THREADSAFE_REFCOUNTING(GlobalInterfaceTableCookie)
GlobalInterfaceTableCookie(const GlobalInterfaceTableCookie&) = delete;
GlobalInterfaceTableCookie(GlobalInterfaceTableCookie&&) = delete;
GlobalInterfaceTableCookie& operator=(const GlobalInterfaceTableCookie&) =
delete;
GlobalInterfaceTableCookie& operator=(GlobalInterfaceTableCookie&&) = delete;
private:
~GlobalInterfaceTableCookie();
private:
DWORD mCookie;
private:
static IGlobalInterfaceTable* ObtainGit();
};
} // namespace detail
/**
* This class encapsulates an "agile reference." These are references that
* allow you to pass COM interfaces between apartments. When you have an
* interface that you would like to pass between apartments, you wrap that
* interface in an AgileReference and pass the agile reference instead. Then
* you unwrap the interface by calling AgileReference::Resolve.
*
* Sample usage:
*
* // In the multithreaded apartment, foo is an IFoo*
* auto myAgileRef = MakeUnique<AgileReference>(IID_IFoo, foo);
*
* // myAgileRef is passed to our main thread, which runs in a single-threaded
* // apartment:
*
* RefPtr<IFoo> foo;
* HRESULT hr = myAgileRef->Resolve(IID_IFoo, getter_AddRefs(foo));
* // Now foo may be called from the main thread
*/
class AgileReference final {
public:
AgileReference();
template <typename InterfaceT>
explicit AgileReference(RefPtr<InterfaceT>& aObject)
: AgileReference(__uuidof(InterfaceT), aObject) {}
AgileReference(REFIID aIid, IUnknown* aObject);
AgileReference(const AgileReference& aOther) = default;
AgileReference(AgileReference&& aOther);
~AgileReference();
explicit operator bool() const {
return mAgileRef || (mGitCookie && mGitCookie->IsValid());
}
HRESULT GetHResult() const { return mHResult; }
template <typename T>
void Assign(const RefPtr<T>& aOther) {
Assign(__uuidof(T), aOther);
}
template <typename T>
AgileReference& operator=(const RefPtr<T>& aOther) {
Assign(aOther);
return *this;
}
HRESULT Resolve(REFIID aIid, void** aOutInterface) const;
AgileReference& operator=(const AgileReference& aOther);
AgileReference& operator=(AgileReference&& aOther);
AgileReference& operator=(decltype(nullptr)) {
Clear();
return *this;
}
void Clear();
private:
void Assign(REFIID aIid, IUnknown* aObject);
void AssignInternal(IUnknown* aObject);
private:
IID mIid;
RefPtr<IAgileReference> mAgileRef;
RefPtr<detail::GlobalInterfaceTableCookie> mGitCookie;
HRESULT mHResult;
};
} // namespace mscom
} // namespace mozilla
template <typename T>
RefPtr<T>::RefPtr(const mozilla::mscom::AgileReference& aAgileRef)
: mRawPtr(nullptr) {
(*this) = aAgileRef;
}
template <typename T>
RefPtr<T>& RefPtr<T>::operator=(
const mozilla::mscom::AgileReference& aAgileRef) {
void* newRawPtr;
if (FAILED(aAgileRef.Resolve(__uuidof(T), &newRawPtr))) {
newRawPtr = nullptr;
}
assign_assuming_AddRef(static_cast<T*>(newRawPtr));
return *this;
}
#endif // mozilla_mscom_AgileReference_h