combaseapi.h

//+---------------------------------------------------------------------------

// Microsoft Windows

// File: combaseapi.h

// Contents: Base Component Object Model defintions.

//----------------------------------------------------------------------------

#include <apiset.h>

#include <apisetcconv.h>

//TODO version number should be bumped when _APISET_TARGET_VERSION_WIN10_RS2 becomes available

#include <rpc.h>

#include <rpcndr.h>

#if (NTDDI_VERSION >= NTDDI_VISTA && !defined(_WIN32_WINNT))

#define _WIN32_WINNT 0x0600 #endif

#if (NTDDI_VERSION >= NTDDI_WS03 && !defined(_WIN32_WINNT))

#define _WIN32_WINNT 0x0502 #endif

#if (NTDDI_VERSION >= NTDDI_WINXP && !defined(_WIN32_WINNT))

#define _WIN32_WINNT 0x0501 #endif

#if (NTDDI_VERSION >= NTDDI_WIN2K && !defined(_WIN32_WINNT))

#define _WIN32_WINNT 0x0500 #endif

#if !defined(_COMBASEAPI_H_)

#define _COMBASEAPI_H_

#ifdef _MSC_VER

#pragma once

#endif // _MSC_VER

#include <pshpack8.h>

//TODO change _OLE32_ to _COMBASEAPI_

#ifdef _OLE32_

#define WINOLEAPI STDAPI

#define WINOLEAPI_(type) STDAPI_(type)

#else

#ifdef _68K_

#ifndef REQUIRESAPPLEPASCAL

#define WINOLEAPI EXTERN_C DECLSPEC_IMPORT HRESULT PASCAL

#define WINOLEAPI_(type) EXTERN_C DECLSPEC_IMPORT type PASCAL

#else

#define WINOLEAPI EXTERN_C DECLSPEC_IMPORT PASCAL HRESULT

#define WINOLEAPI_(type) EXTERN_C DECLSPEC_IMPORT PASCAL type

#endif

#else

#define WINOLEAPI EXTERN_C DECLSPEC_IMPORT HRESULT STDAPICALLTYPE

#define WINOLEAPI_(type) EXTERN_C DECLSPEC_IMPORT type STDAPICALLTYPE #endif

#endif

#pragma region Application or OneCore Family

#if WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_APP | WINAPI_PARTITION_SYSTEM)

/****** Interface Declaration ***********************************************/

/* * These are macros for declaring interfaces. They exist so that * a single definition of the interface is simulataneously a proper * declaration of the interface structures (C++ abstract classes) * for both C and C++. * * DECLARE_INTERFACE(iface) is used to declare an interface that does * not derive from a base interface. * DECLARE_INTERFACE_(iface, baseiface) is used to declare an interface * that does derive from a base interface. * * By default if the source file has a .c extension the C version of * the interface declaratations will be expanded; if it has a .cpp * extension the C++ version will be expanded. if you want to force * the C version expansion even though the source file has a .cpp * extension, then define the macro "CINTERFACE". * eg. cl -DCINTERFACE file.cpp * * Example Interface declaration: * * #undef INTERFACE * #define INTERFACE IClassFactory * * DECLARE_INTERFACE_(IClassFactory, IUnknown) * { * // *** IUnknown methods *** * STDMETHOD(QueryInterface) (THIS_ * REFIID riid, * LPVOID FAR* ppvObj) PURE; * STDMETHOD_(ULONG,AddRef) (THIS) PURE; * STDMETHOD_(ULONG,Release) (THIS) PURE; * * // *** IClassFactory methods *** * STDMETHOD(CreateInstance) (THIS_ * LPUNKNOWN pUnkOuter, * REFIID riid, * LPVOID FAR* ppvObject) PURE; * }; * * Example C++ expansion: * * struct FAR IClassFactory : public IUnknown * { * virtual HRESULT STDMETHODCALLTYPE QueryInterface( * IID FAR& riid, * LPVOID FAR* ppvObj) = 0; * virtual HRESULT STDMETHODCALLTYPE AddRef(void) = 0; * virtual HRESULT STDMETHODCALLTYPE Release(void) = 0; * virtual HRESULT STDMETHODCALLTYPE CreateInstance( * LPUNKNOWN pUnkOuter, * IID FAR& riid, * LPVOID FAR* ppvObject) = 0; * }; * * NOTE: Our documentation says '#define interface class' but we use * 'struct' instead of 'class' to keep a lot of 'public:' lines * out of the interfaces. The 'FAR' forces the 'this' pointers to * be far, which is what we need. * * Example C expansion: * * typedef struct IClassFactory * { * const struct IClassFactoryVtbl FAR* lpVtbl; * } IClassFactory; * * typedef struct IClassFactoryVtbl IClassFactoryVtbl; * * struct IClassFactoryVtbl * { * HRESULT (STDMETHODCALLTYPE * QueryInterface) ( * IClassFactory FAR* This, * IID FAR* riid, * LPVOID FAR* ppvObj) ; * HRESULT (STDMETHODCALLTYPE * AddRef) (IClassFactory FAR* This) ; * HRESULT (STDMETHODCALLTYPE * Release) (IClassFactory FAR* This) ; * HRESULT (STDMETHODCALLTYPE * CreateInstance) ( * IClassFactory FAR* This, * LPUNKNOWN pUnkOuter, * IID FAR* riid, * LPVOID FAR* ppvObject); * HRESULT (STDMETHODCALLTYPE * LockServer) ( * IClassFactory FAR* This, * BOOL fLock); * }; */

#if defined(__cplusplus) && !defined(CINTERFACE)

//#define interface struct FAR

#ifdef COM_STDMETHOD_CAN_THROW

#define COM_DECLSPEC_NOTHROW

#else

#define COM_DECLSPEC_NOTHROW DECLSPEC_NOTHROW #endif

#define __STRUCT__ struct

#define interface __STRUCT__

#define STDMETHOD(method) virtual COM_DECLSPEC_NOTHROW HRESULT STDMETHODCALLTYPE method

#define STDMETHOD_(type,method) virtual COM_DECLSPEC_NOTHROW type STDMETHODCALLTYPE method

#define STDMETHODV(method) virtual COM_DECLSPEC_NOTHROW HRESULT STDMETHODVCALLTYPE method

#define STDMETHODV_(type,method) virtual COM_DECLSPEC_NOTHROW type STDMETHODVCALLTYPE method

#define PURE = 0

#define THIS_

#define THIS void

#define DECLARE_INTERFACE(iface) interface DECLSPEC_NOVTABLE iface

#define DECLARE_INTERFACE_(iface, baseiface) interface DECLSPEC_NOVTABLE iface : public baseiface

#define DECLARE_INTERFACE_IID(iface, iid) interface DECLSPEC_UUID(iid) DECLSPEC_NOVTABLE iface

#define DECLARE_INTERFACE_IID_(iface, baseiface, iid) interface DECLSPEC_UUID(iid) DECLSPEC_NOVTABLE iface : public baseiface

#define IFACEMETHOD(method) __override STDMETHOD(method)

#define IFACEMETHOD_(type,method) __override STDMETHOD_(type,method)

#define IFACEMETHODV(method) __override STDMETHODV(method)

#define IFACEMETHODV_(type,method) __override STDMETHODV_(type,method)

#if !defined(BEGIN_INTERFACE)

#if defined(_MPPC_) && ((defined(_MSC_VER) || defined(__SC__) || defined(__MWERKS__)) && !defined(NO_NULL_VTABLE_ENTRY))

#define BEGIN_INTERFACE virtual void a() {}

#define END_INTERFACE #else

#define BEGIN_INTERFACE

#define END_INTERFACE #endif #endif

#ifndef SORTPP_PASS

// This forward declaration has been left where this type was previously defined, to preserve ordering.

extern

"C++"

{

template<typename T> _Post_equal_to_(pp) _Post_satisfies_(return == pp) void** IID_PPV_ARGS_Helper(T** pp);

template

typename

void

IID_PPV_ARGS_Helper

(

);

}

#endif // !SORTPP_PASS

#define IID_PPV_ARGS(ppType) __uuidof(**(ppType)), IID_PPV_ARGS_Helper(ppType)

#else

#define interface struct

#define STDMETHOD(method) HRESULT (STDMETHODCALLTYPE * method)

#define STDMETHOD_(type,method) type (STDMETHODCALLTYPE * method)

#define STDMETHODV(method) HRESULT (STDMETHODVCALLTYPE * method)

#define STDMETHODV_(type,method) type (STDMETHODVCALLTYPE * method)

#define IFACEMETHOD(method) __override STDMETHOD(method)

#define IFACEMETHOD_(type,method) __override STDMETHOD_(type,method)

#define IFACEMETHODV(method) __override STDMETHODV(method)

#define IFACEMETHODV_(type,method) __override STDMETHODV_(type,method)

#if !defined(BEGIN_INTERFACE)

#if defined(_MPPC_)

#define BEGIN_INTERFACE void *b;

#define END_INTERFACE

#else

#define BEGIN_INTERFACE

#define END_INTERFACE

#endif

#define PURE

#define THIS_ INTERFACE FAR* This,

#define THIS INTERFACE FAR* This

#ifdef CONST_VTABLE

#undef CONST_VTBL

#define CONST_VTBL const

#define DECLARE_INTERFACE(iface) typedef interface iface { \

const struct iface##Vtbl FAR* lpVtbl; \

} iface; \

typedef const struct iface##Vtbl iface##Vtbl; \

const struct iface##Vtbl

#else

#undef CONST_VTBL

#define CONST_VTBL

#define DECLARE_INTERFACE(iface) typedef interface iface { \

struct iface##Vtbl FAR* lpVtbl; \

} iface; \

typedef struct iface##Vtbl iface##Vtbl; \

struct iface##Vtbl

#endif

#define DECLARE_INTERFACE_(iface, baseiface) DECLARE_INTERFACE(iface)

#define DECLARE_INTERFACE_IID(iface, iid) DECLARE_INTERFACE(iface)

#define DECLARE_INTERFACE_IID_(iface, baseiface, iid) DECLARE_INTERFACE_(iface, baseiface) #endif

/****** Additional basic types **********************************************/

#ifndef FARSTRUCT

#ifdef __cplusplus

#define FARSTRUCT FAR

#else

#define FARSTRUCT #endif // __cplusplus #endif // FARSTRUCT

#ifndef HUGEP

#if defined(_WIN32) || defined(_MPPC_)

#define HUGEP

#else

#define HUGEP __huge #endif // WIN32 #endif // HUGEP

#include <stdlib.h>

#define LISet32(li, v) ((li).HighPart = ((LONG) (v)) < 0 ? -1 : 0, (li).LowPart = (v))

#define ULISet32(li, v) ((li).HighPart = 0, (li).LowPart = (v))

#define CLSCTX_INPROC (CLSCTX_INPROC_SERVER|CLSCTX_INPROC_HANDLER)

// With DCOM, CLSCTX_REMOTE_SERVER should be included

// DCOM

#if (_WIN32_WINNT >= 0x0400) || defined(_WIN32_DCOM)

#define CLSCTX_ALL (CLSCTX_INPROC_SERVER| \

CLSCTX_INPROC_HANDLER| \

CLSCTX_LOCAL_SERVER| \

CLSCTX_REMOTE_SERVER)

#define CLSCTX_SERVER (CLSCTX_INPROC_SERVER|CLSCTX_LOCAL_SERVER|CLSCTX_REMOTE_SERVER)

#else

#define CLSCTX_ALL (CLSCTX_INPROC_SERVER| \

CLSCTX_INPROC_HANDLER| \

CLSCTX_LOCAL_SERVER )

#define CLSCTX_SERVER (CLSCTX_INPROC_SERVER|CLSCTX_LOCAL_SERVER) #endif

// class registration flags; passed to CoRegisterClassObject

typedef

enum

tagREGCLS

{

REGCLS_SINGLEUSE

// class object only generates one instance

REGCLS_MULTIPLEUSE

// same class object genereates multiple inst.

// and local automatically goes into inproc tbl.

REGCLS_MULTI_SEPARATE

// multiple use, but separate control over each

// context.

REGCLS_SUSPENDED

// register is as suspended, will be activated

// when app calls CoResumeClassObjects

REGCLS_SURROGATE

// must be used when a surrogate process

// is registering a class object that will be

// loaded in the surrogate

#if (NTDDI_VERSION >= NTDDI_WINTHRESHOLD)

REGCLS_AGILE

0x10

// Class object aggregates the free-threaded marshaler

// and will be made visible to all inproc apartments.

// Can be used together with other flags - for example,

// REGCLS_AGILE | REGCLS_MULTIPLEUSE to register a

// class object that can be used multiple times from

// different apartments. Without other flags, behavior

// will retain REGCLS_SINGLEUSE semantics in that only

// one instance can be generated.

#endif

}

REGCLS

;

/* here is where we pull in the MIDL generated headers for the interfaces */

typedef interface IRpcStubBuffer IRpcStubBuffer;

typedef

struct

IRpcStubBuffer

;

typedef interface IRpcChannelBuffer IRpcChannelBuffer;

typedef

struct

IRpcChannelBuffer

;

// COM initialization flags; passed to CoInitialize.

typedef

enum

tagCOINITBASE

{

// DCOM

#if (_WIN32_WINNT >= 0x0400) || defined(_WIN32_DCOM)

// These constants are only valid on Windows NT 4.0

COINITBASE_MULTITHREADED

0x0

// OLE calls objects on any thread.

#endif // DCOM

}

COINITBASE

;

#include <wtypesbase.h> #include <unknwnbase.h>

#if defined(__cplusplus) && !defined(CINTERFACE)

// IID_PPV_ARGS(ppType)

// ppType is the variable of type IType that will be filled

// RESULTS in: IID_IType, ppvType

// will create a compiler error if wrong level of indirection is used.

extern

"C++"

{

template<typename T> _Post_equal_to_(pp) _Post_satisfies_(return == pp) void** IID_PPV_ARGS_Helper(T** pp)

template

typename

void

IID_PPV_ARGS_Helper

(

)

{ #pragma prefast(suppress:

6269

"Tool issue with unused static_cast"

)

static_cast

IUnknown

*>(*

);

// make sure everyone derives from IUnknown

return

reinterpret_cast

void

**>(

); } }

#endif // defined(__cplusplus) && !defined(CINTERFACE)

#include <objidlbase.h>

#include <guiddef.h>

#ifndef INITGUID

// TODO change to cguidbase.h

#include <cguid.h> #endif

#endif // WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_APP | WINAPI_PARTITION_SYSTEM)

#pragma endregion

/****** STD Object API Prototypes *****************************************/

#pragma region Desktop or OneCore Family

#if WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_DESKTOP | WINAPI_PARTITION_SYSTEM)

_Check_return_ WINOLEAPI

extern

"C"

__declspec

(dllimport)

HRESULT

__stdcall

CoGetMalloc

(

_In_ DWORD dwMemContext,

DWORD

dwMemContext

_Outptr_ LPMALLOC FAR * ppMalloc

LPMALLOC

ppMalloc

);

#endif // WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_DESKTOP | WINAPI_PARTITION_SYSTEM)

#pragma endregion #pragma region Application or OneCore Family

#if WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_APP | WINAPI_PARTITION_SYSTEM)

_Check_return_ WINOLEAPI

extern

"C"

__declspec

(dllimport)

HRESULT

__stdcall

CreateStreamOnHGlobal

(

HGLOBAL

hGlobal

_In_ BOOL fDeleteOnRelease,

BOOL

fDeleteOnRelease

_Outptr_ LPSTREAM FAR * ppstm

LPSTREAM

ppstm

);

_Check_return_ WINOLEAPI

extern

"C"

__declspec

(dllimport)

HRESULT

__stdcall

GetHGlobalFromStream

(

_In_ LPSTREAM pstm,

LPSTREAM

pstm

_Out_ HGLOBAL FAR * phglobal

HGLOBAL

phglobal

);

/* init/uninit */

WINOLEAPI_(void)

extern

"C"

__declspec

(dllimport)

void

__stdcall

CoUninitialize

(

void

);

#endif // WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_APP | WINAPI_PARTITION_SYSTEM)

#pragma endregion #pragma region Desktop or OneCore Family

#if WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_DESKTOP | WINAPI_PARTITION_SYSTEM)

WINOLEAPI_(DWORD)

extern

"C"

__declspec

(dllimport)

DWORD

__stdcall

CoGetCurrentProcess

(

void

);

#endif // WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_DESKTOP | WINAPI_PARTITION_SYSTEM)

#pragma endregion

// DCOM

#if (_WIN32_WINNT >= 0x0400) || defined(_WIN32_DCOM)

#pragma region Application or OneCore Family

#if WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_APP | WINAPI_PARTITION_SYSTEM)

_Check_return_ WINOLEAPI

extern

"C"

__declspec

(dllimport)

HRESULT

__stdcall

CoInitializeEx

(

_In_opt_ LPVOID pvReserved,

LPVOID

pvReserved

_In_ DWORD dwCoInit

DWORD

dwCoInit

);

#endif // WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_APP | WINAPI_PARTITION_SYSTEM)

#pragma endregion #pragma region Desktop or OneCore Family

#if WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_DESKTOP | WINAPI_PARTITION_SYSTEM)

WINOLEAPI

extern

"C"

__declspec

(dllimport)

HRESULT

__stdcall

CoGetCallerTID

(

_Out_ LPDWORD lpdwTID

LPDWORD

lpdwTID

);

#endif // WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_DESKTOP | WINAPI_PARTITION_SYSTEM)

#pragma endregion #pragma region Application or OneCore Family

#if WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_APP | WINAPI_PARTITION_SYSTEM)

WINOLEAPI

extern

"C"

__declspec

(dllimport)

HRESULT

__stdcall

CoGetCurrentLogicalThreadId

(

_Out_ GUID* pguid

GUID

pguid

);

#endif // WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_APP | WINAPI_PARTITION_SYSTEM)

#pragma endregion

#endif // DCOM

#if (_WIN32_WINNT >= 0x0501)

#pragma region Application or OneCore Family

#if WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_APP | WINAPI_PARTITION_SYSTEM)

_Check_return_ WINOLEAPI

extern

"C"

__declspec

(dllimport)

HRESULT

__stdcall

CoGetContextToken

(

_Out_ ULONG_PTR* pToken

ULONG_PTR

pToken

);

#endif // WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_APP | WINAPI_PARTITION_SYSTEM)

#pragma endregion #pragma region Desktop or OneCore Family

#if WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_DESKTOP | WINAPI_PARTITION_SYSTEM)

_Check_return_ WINOLEAPI

extern

"C"

__declspec

(dllimport)

HRESULT

__stdcall

CoGetDefaultContext

(

_In_ APTTYPE aptType,

APTTYPE

aptType

_In_ REFIID riid,

const

IID

riid

_Outptr_ void** ppv

void

ppv

);

#endif // WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_DESKTOP | WINAPI_PARTITION_SYSTEM)

#pragma endregion

#endif

#pragma region Application or OneCore Family

#if WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_APP | WINAPI_PARTITION_SYSTEM)

// definition for Win7 new APIs

#if (NTDDI_VERSION >= NTDDI_WIN7)

_Check_return_ WINOLEAPI

extern

"C"

__declspec

(dllimport)

HRESULT

__stdcall

CoGetApartmentType

(

_Out_ APTTYPE* pAptType,

APTTYPE

pAptType

_Out_ APTTYPEQUALIFIER* pAptQualifier

APTTYPEQUALIFIER

pAptQualifier

);

#endif

#endif // WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_APP | WINAPI_PARTITION_SYSTEM)

#pragma endregion

// definition for Win8 new APIs

#if (NTDDI_VERSION >= NTDDI_WIN8)

#pragma region Application or OneCore Family

#if WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_APP | WINAPI_PARTITION_SYSTEM)

typedef

struct

tagServerInformation

{

DWORD

dwServerPid

;

DWORD

dwServerTid

;

UINT64

ui64ServerAddress

; }

ServerInformation

, *

PServerInformation

;

#endif // WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_APP | WINAPI_PARTITION_SYSTEM)

#pragma endregion #pragma region Desktop or OneCore Family

#if WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_DESKTOP | WINAPI_PARTITION_SYSTEM)

_Check_return_ WINOLEAPI

extern

"C"

__declspec

(dllimport)

HRESULT

__stdcall

CoDecodeProxy

(

_In_ DWORD dwClientPid,

DWORD

dwClientPid

_In_ UINT64 ui64ProxyAddress,

UINT64

ui64ProxyAddress

_Out_ PServerInformation pServerInformation

PServerInformation

pServerInformation

);

#endif // WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_DESKTOP | WINAPI_PARTITION_SYSTEM)

#pragma endregion #pragma region Application or OneCore Family

#if WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_APP | WINAPI_PARTITION_SYSTEM)

DECLARE_HANDLE(CO_MTA_USAGE_COOKIE);

struct

CO_MTA_USAGE_COOKIE__

{

int

unused

;};

typedef

struct

CO_MTA_USAGE_COOKIE__

CO_MTA_USAGE_COOKIE

;

_Check_return_ WINOLEAPI

extern

"C"

__declspec

(dllimport)

HRESULT

__stdcall

CoIncrementMTAUsage

(

_Out_ CO_MTA_USAGE_COOKIE* pCookie

CO_MTA_USAGE_COOKIE

pCookie

);

WINOLEAPI

extern

"C"

__declspec

(dllimport)

HRESULT

__stdcall

CoDecrementMTAUsage

(

_In_ CO_MTA_USAGE_COOKIE Cookie

CO_MTA_USAGE_COOKIE

);

#endif // WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_APP | WINAPI_PARTITION_SYSTEM)

#pragma endregion #pragma region Desktop or OneCore Family

#if WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_DESKTOP | WINAPI_PARTITION_SYSTEM)

WINOLEAPI

extern

"C"

__declspec

(dllimport)

HRESULT

__stdcall

CoAllowUnmarshalerCLSID

(

_In_ REFCLSID clsid

const

IID

clsid

);

// Predefine _EXE_INITIALIZE_MTA to have the runtime initialize an MTA for your process

// prior to initializing globals (i.e. dynamic initializers)

// _EXE_INITIALIZE_MTA et al. are too long for rc

#if !defined RC_INVOKED

#if defined _M_IX86

#define _CRT_INTERNAL_COMBASE_SYMBOL_PREFIX "_"

#elif defined _M_X64 || defined _M_ARM || defined _M_ARM64

#define _CRT_INTERNAL_COMBASE_SYMBOL_PREFIX "" #endif

#if defined _EXE_INITIALIZE_MTA && !defined _M_CEE

#pragma comment(lib, "exe_initialize_mta")

#pragma comment(linker, "/include:" _CRT_INTERNAL_COMBASE_SYMBOL_PREFIX "__PLEASE_LINK_WITH_exe_initialize_mta.lib") #endif #endif

#endif // WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_DESKTOP | WINAPI_PARTITION_SYSTEM)

#pragma endregion

#endif

#pragma region Application or OneCore Family

#if WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_APP | WINAPI_PARTITION_SYSTEM)

_Check_return_ WINOLEAPI

extern

"C"

__declspec

(dllimport)

HRESULT

__stdcall

CoGetObjectContext

(

_In_ REFIID riid,

const

IID

riid

_Outptr_ LPVOID FAR * ppv

LPVOID

ppv

);

#endif // WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_APP | WINAPI_PARTITION_SYSTEM)

#pragma endregion #pragma region Desktop or OneCore Family

#if WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_DESKTOP | WINAPI_PARTITION_SYSTEM)

/* register/revoke/get class objects */

_Check_return_ WINOLEAPI

extern

"C"

__declspec

(dllimport)

HRESULT

__stdcall

CoGetClassObject

(

_In_ REFCLSID rclsid,

const

IID

rclsid

_In_ DWORD dwClsContext,

DWORD

dwClsContext

_In_opt_ LPVOID pvReserved,

LPVOID

pvReserved

_In_ REFIID riid,

const

IID

riid

_Outptr_ LPVOID FAR * ppv

LPVOID

ppv

);

#endif // WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_DESKTOP | WINAPI_PARTITION_SYSTEM)

#pragma endregion #pragma region Application or OneCore Family

#if WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_APP | WINAPI_PARTITION_SYSTEM)

_Check_return_ WINOLEAPI

extern

"C"

__declspec

(dllimport)

HRESULT

__stdcall

CoRegisterClassObject

(

_In_ REFCLSID rclsid,

const

IID

rclsid

_In_ LPUNKNOWN pUnk,

LPUNKNOWN

pUnk

_In_ DWORD dwClsContext,

DWORD

dwClsContext

_In_ DWORD flags,

DWORD

flags

_Out_ LPDWORD lpdwRegister

LPDWORD

lpdwRegister

);

WINOLEAPI

extern

"C"

__declspec

(dllimport)

HRESULT

__stdcall

CoRevokeClassObject

(

_In_ DWORD dwRegister

DWORD

dwRegister

);

_Check_return_ WINOLEAPI

extern

"C"

__declspec

(dllimport)

HRESULT

__stdcall

CoResumeClassObjects

(

void

);

_Check_return_ WINOLEAPI

extern

"C"

__declspec

(dllimport)

HRESULT

__stdcall

CoSuspendClassObjects

(

void

);

#endif // WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_APP | WINAPI_PARTITION_SYSTEM)

#pragma endregion #pragma region Desktop or OneCore Family

#if WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_DESKTOP | WINAPI_PARTITION_SYSTEM)

WINOLEAPI_(ULONG)

extern

"C"

__declspec

(dllimport)

ULONG

__stdcall

CoAddRefServerProcess

(

void

);

WINOLEAPI_(ULONG)

extern

"C"

__declspec

(dllimport)

ULONG

__stdcall

CoReleaseServerProcess

(

void

);

_Check_return_ WINOLEAPI

extern

"C"

__declspec

(dllimport)

HRESULT

__stdcall

CoGetPSClsid

(

_In_ REFIID riid,

const

IID

riid

_Out_ CLSID* pClsid

CLSID

pClsid

);

_Check_return_ WINOLEAPI

extern

"C"

__declspec

(dllimport)

HRESULT

__stdcall

CoRegisterPSClsid

(

_In_ REFIID riid,

const

IID

riid

_In_ REFCLSID rclsid

const

IID

rclsid

);

// Registering surrogate processes

_Check_return_ WINOLEAPI

extern

"C"

__declspec

(dllimport)

HRESULT

__stdcall

CoRegisterSurrogate

(

_In_ LPSURROGATE pSurrogate

LPSURROGATE

pSurrogate

);

#endif // WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_DESKTOP | WINAPI_PARTITION_SYSTEM)

#pragma endregion #pragma region Application or OneCore Family

#if WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_APP | WINAPI_PARTITION_SYSTEM)

/* marshaling interface pointers */

_Check_return_ WINOLEAPI

extern

"C"

__declspec

(dllimport)

HRESULT

__stdcall

CoGetMarshalSizeMax

(

_Out_ ULONG* pulSize,

ULONG

pulSize

_In_ REFIID riid,

const

IID

riid

_In_ LPUNKNOWN pUnk,

LPUNKNOWN

pUnk

_In_ DWORD dwDestContext,

DWORD

dwDestContext

_In_opt_ LPVOID pvDestContext,

LPVOID

pvDestContext

_In_ DWORD mshlflags

DWORD

mshlflags

);

_Check_return_ WINOLEAPI

extern

"C"

__declspec

(dllimport)

HRESULT

__stdcall

CoMarshalInterface

(

_In_ LPSTREAM pStm,

LPSTREAM

pStm

_In_ REFIID riid,

const

IID

riid

_In_ LPUNKNOWN pUnk,

LPUNKNOWN

pUnk

_In_ DWORD dwDestContext,

DWORD

dwDestContext

_In_opt_ LPVOID pvDestContext,

LPVOID

pvDestContext

_In_ DWORD mshlflags

DWORD

mshlflags

);

_Check_return_ WINOLEAPI

extern

"C"

__declspec

(dllimport)

HRESULT

__stdcall

CoUnmarshalInterface

(

_In_ LPSTREAM pStm,

LPSTREAM

pStm

_In_ REFIID riid,

const

IID

riid

_COM_Outptr_ LPVOID FAR * ppv

LPVOID

ppv

);

#endif // WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_APP | WINAPI_PARTITION_SYSTEM)

#pragma endregion #pragma region Desktop or OneCore Family

#if WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_DESKTOP | WINAPI_PARTITION_SYSTEM)

WINOLEAPI

extern

"C"

__declspec

(dllimport)

HRESULT

__stdcall

CoMarshalHresult

(

_In_ LPSTREAM pstm,

LPSTREAM

pstm

_In_ HRESULT hresult

HRESULT

hresult

);

WINOLEAPI

extern

"C"

__declspec

(dllimport)

HRESULT

__stdcall

CoUnmarshalHresult

(

_In_ LPSTREAM pstm,

LPSTREAM

pstm

_Out_ HRESULT FAR * phresult

HRESULT

phresult

);

#endif // WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_DESKTOP | WINAPI_PARTITION_SYSTEM)

#pragma endregion #pragma region Application or OneCore Family

#if WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_APP | WINAPI_PARTITION_SYSTEM)

_Check_return_ WINOLEAPI

extern

"C"

__declspec

(dllimport)

HRESULT

__stdcall

CoReleaseMarshalData

(

_In_ LPSTREAM pStm

LPSTREAM

pStm

);

_Check_return_ WINOLEAPI

extern

"C"

__declspec

(dllimport)

HRESULT

__stdcall

CoDisconnectObject

(

_In_ LPUNKNOWN pUnk,

LPUNKNOWN

pUnk

_In_ DWORD dwReserved

DWORD

dwReserved

);

#endif // WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_APP | WINAPI_PARTITION_SYSTEM)

#pragma endregion #pragma region Desktop or OneCore Family

#if WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_DESKTOP | WINAPI_PARTITION_SYSTEM)

_Check_return_ WINOLEAPI

extern

"C"

__declspec

(dllimport)

HRESULT

__stdcall

CoLockObjectExternal

(

_In_ LPUNKNOWN pUnk,

LPUNKNOWN

pUnk

_In_ BOOL fLock,

BOOL

fLock

_In_ BOOL fLastUnlockReleases

BOOL

fLastUnlockReleases

);

#endif // WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_DESKTOP | WINAPI_PARTITION_SYSTEM)

#pragma endregion #pragma region Application or OneCore Family

#if WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_APP | WINAPI_PARTITION_SYSTEM)

_Check_return_ WINOLEAPI

extern

"C"

__declspec

(dllimport)

HRESULT

__stdcall

CoGetStandardMarshal

(

_In_ REFIID riid,

const

IID

riid

_In_ LPUNKNOWN pUnk,

LPUNKNOWN

pUnk

_In_ DWORD dwDestContext,

DWORD

dwDestContext

_In_opt_ LPVOID pvDestContext,

LPVOID

pvDestContext

_In_ DWORD mshlflags,

DWORD

mshlflags

_Outptr_ LPMARSHAL FAR * ppMarshal

LPMARSHAL

ppMarshal

);

#endif // WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_APP | WINAPI_PARTITION_SYSTEM)

#pragma endregion #pragma region Desktop or OneCore Family

#if WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_DESKTOP | WINAPI_PARTITION_SYSTEM)

_Check_return_ WINOLEAPI

extern

"C"

__declspec

(dllimport)

HRESULT

__stdcall

CoGetStdMarshalEx

(

_In_ LPUNKNOWN pUnkOuter,

LPUNKNOWN

pUnkOuter

_In_ DWORD smexflags,

DWORD

smexflags

_Outptr_ LPUNKNOWN FAR * ppUnkInner

LPUNKNOWN

ppUnkInner

);

#endif // WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_DESKTOP | WINAPI_PARTITION_SYSTEM)

#pragma endregion #pragma region Application or OneCore Family

#if WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_APP | WINAPI_PARTITION_SYSTEM)

/* flags for CoGetStdMarshalEx */

typedef

enum

tagSTDMSHLFLAGS

{

SMEXF_SERVER

0x01

// server side aggregated std marshaler

SMEXF_HANDLER

0x02

// client side (handler) agg std marshaler

}

STDMSHLFLAGS

;

#endif // WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_APP | WINAPI_PARTITION_SYSTEM)

#pragma endregion #pragma region Desktop or OneCore Family

#if WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_DESKTOP | WINAPI_PARTITION_SYSTEM)

WINOLEAPI_(BOOL)

extern

"C"

__declspec

(dllimport)

BOOL

__stdcall

CoIsHandlerConnected

(

_In_ LPUNKNOWN pUnk

LPUNKNOWN

pUnk

);

#endif // WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_DESKTOP | WINAPI_PARTITION_SYSTEM)

#pragma endregion #pragma region Application or OneCore Family

#if WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_APP | WINAPI_PARTITION_SYSTEM)

// Apartment model inter-thread interface passing helpers

_Check_return_ WINOLEAPI

extern

"C"

__declspec

(dllimport)

HRESULT

__stdcall

CoMarshalInterThreadInterfaceInStream

(

_In_ REFIID riid,

const

IID

riid

_In_ LPUNKNOWN pUnk,

LPUNKNOWN

pUnk

_Outptr_ LPSTREAM* ppStm

LPSTREAM

ppStm

);

_Check_return_ WINOLEAPI

extern

"C"

__declspec

(dllimport)

HRESULT

__stdcall

CoGetInterfaceAndReleaseStream

(

_In_ LPSTREAM pStm,

LPSTREAM

pStm

_In_ REFIID iid,

const

IID

iid

_COM_Outptr_ LPVOID FAR * ppv

LPVOID

ppv

);

_Check_return_ WINOLEAPI

extern

"C"

__declspec

(dllimport)

HRESULT

__stdcall

CoCreateFreeThreadedMarshaler

(

_In_opt_ LPUNKNOWN punkOuter,

LPUNKNOWN

punkOuter

_Outptr_ LPUNKNOWN* ppunkMarshal

LPUNKNOWN

ppunkMarshal

);

WINOLEAPI_(void)

extern

"C"

__declspec

(dllimport)

void

__stdcall

CoFreeUnusedLibraries

(

void

);

#if (_WIN32_WINNT >= 0x0501)

WINOLEAPI_(void)

extern

"C"

__declspec

(dllimport)

void

__stdcall

CoFreeUnusedLibrariesEx

(

_In_ DWORD dwUnloadDelay,

DWORD

dwUnloadDelay

_In_ DWORD dwReserved

DWORD

dwReserved

);

#endif

#endif // WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_APP | WINAPI_PARTITION_SYSTEM)

#pragma endregion

#if (_WIN32_WINNT >= 0x0600)

#pragma region Desktop or OneCore Family

#if WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_DESKTOP | WINAPI_PARTITION_SYSTEM)

_Check_return_ WINOLEAPI

extern

"C"

__declspec

(dllimport)

HRESULT

__stdcall

CoDisconnectContext

(

DWORD

dwTimeout

);

#endif // WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_DESKTOP | WINAPI_PARTITION_SYSTEM)

#pragma endregion

#endif

// DCOM

#if (_WIN32_WINNT >= 0x0400) || defined(_WIN32_DCOM)

#pragma region Application or OneCore Family

#if WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_APP | WINAPI_PARTITION_SYSTEM)

/* Call Security. */

_Check_return_ WINOLEAPI

extern

"C"

__declspec

(dllimport)

HRESULT

__stdcall

CoInitializeSecurity

(

_In_opt_ PSECURITY_DESCRIPTOR pSecDesc,

PSECURITY_DESCRIPTOR

pSecDesc

_In_ LONG cAuthSvc,

LONG

cAuthSvc

_In_reads_opt_(cAuthSvc) SOLE_AUTHENTICATION_SERVICE* asAuthSvc,

SOLE_AUTHENTICATION_SERVICE

asAuthSvc

_In_opt_ void* pReserved1,

void

pReserved1

_In_ DWORD dwAuthnLevel,

DWORD

dwAuthnLevel

_In_ DWORD dwImpLevel,

DWORD

dwImpLevel

_In_opt_ void* pAuthList,

void

pAuthList

_In_ DWORD dwCapabilities,

DWORD

dwCapabilities

_In_opt_ void* pReserved3

void

pReserved3

);

#endif // WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_APP | WINAPI_PARTITION_SYSTEM)

#pragma endregion #pragma region Desktop or OneCore Family

#if WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_DESKTOP | WINAPI_PARTITION_SYSTEM)

_Check_return_ WINOLEAPI

extern

"C"

__declspec

(dllimport)

HRESULT

__stdcall

CoGetCallContext

(

_In_ REFIID riid,

const

IID

riid

_Outptr_ void** ppInterface

void

ppInterface

);

_Check_return_ WINOLEAPI

extern

"C"

__declspec

(dllimport)

HRESULT

__stdcall

CoQueryProxyBlanket

(

_In_ IUnknown* pProxy,

IUnknown

pProxy

_Out_opt_ DWORD* pwAuthnSvc,

DWORD

pwAuthnSvc

_Out_opt_ DWORD* pAuthzSvc,

DWORD

pAuthzSvc

_Outptr_opt_ LPOLESTR* pServerPrincName,

LPOLESTR

pServerPrincName

_Out_opt_ DWORD* pAuthnLevel,

DWORD

pAuthnLevel

_Out_opt_ DWORD* pImpLevel,

DWORD

pImpLevel

_Out_opt_ RPC_AUTH_IDENTITY_HANDLE* pAuthInfo,

RPC_AUTH_IDENTITY_HANDLE

pAuthInfo

_Out_opt_ DWORD* pCapabilites

DWORD

pCapabilites

);

_Check_return_ WINOLEAPI

extern

"C"

__declspec

(dllimport)

HRESULT

__stdcall

CoSetProxyBlanket

(

_In_ IUnknown* pProxy,

IUnknown

pProxy

_In_ DWORD dwAuthnSvc,

DWORD

dwAuthnSvc

_In_ DWORD dwAuthzSvc,

DWORD

dwAuthzSvc

_In_opt_ OLECHAR* pServerPrincName,

OLECHAR

pServerPrincName

_In_ DWORD dwAuthnLevel,

DWORD

dwAuthnLevel

_In_ DWORD dwImpLevel,

DWORD

dwImpLevel

_In_opt_ RPC_AUTH_IDENTITY_HANDLE pAuthInfo,

RPC_AUTH_IDENTITY_HANDLE

pAuthInfo

_In_ DWORD dwCapabilities

DWORD

dwCapabilities

);

_Check_return_ WINOLEAPI

extern

"C"

__declspec

(dllimport)

HRESULT

__stdcall

CoCopyProxy

(

_In_ IUnknown* pProxy,

IUnknown

pProxy

_Outptr_ IUnknown** ppCopy

IUnknown

ppCopy

);

_Check_return_ WINOLEAPI

extern

"C"

__declspec

(dllimport)

HRESULT

__stdcall

CoQueryClientBlanket

(

_Out_opt_ DWORD* pAuthnSvc,

DWORD

pAuthnSvc

_Out_opt_ DWORD* pAuthzSvc,

DWORD

pAuthzSvc

_Outptr_opt_ LPOLESTR* pServerPrincName,

LPOLESTR

pServerPrincName

_Out_opt_ DWORD* pAuthnLevel,

DWORD

pAuthnLevel

_Out_opt_ DWORD* pImpLevel,

DWORD

pImpLevel

_Outptr_opt_result_buffer_(_Inexpressible_("depends on pAuthnSvc")) RPC_AUTHZ_HANDLE* pPrivs,

RPC_AUTHZ_HANDLE

pPrivs

_Inout_opt_ DWORD* pCapabilities

DWORD

pCapabilities

);

_Check_return_ WINOLEAPI

extern

"C"

__declspec

(dllimport)

HRESULT

__stdcall

CoImpersonateClient

(

void

);

_Check_return_ WINOLEAPI

extern

"C"

__declspec

(dllimport)

HRESULT

__stdcall

CoRevertToSelf

(

void

);

_Check_return_ WINOLEAPI

extern

"C"

__declspec

(dllimport)

HRESULT

__stdcall

CoQueryAuthenticationServices

(

_Out_ DWORD* pcAuthSvc,

DWORD

pcAuthSvc

_Outptr_result_buffer_(*pcAuthSvc) SOLE_AUTHENTICATION_SERVICE** asAuthSvc

SOLE_AUTHENTICATION_SERVICE

asAuthSvc

);

#endif // WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_DESKTOP | WINAPI_PARTITION_SYSTEM)

#pragma endregion #pragma region Application or OneCore Family

#if WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_APP | WINAPI_PARTITION_SYSTEM)

_Check_return_ WINOLEAPI

extern

"C"

__declspec

(dllimport)

HRESULT

__stdcall

CoSwitchCallContext

(

_In_opt_ IUnknown* pNewObject,

IUnknown

pNewObject

_Outptr_ IUnknown** ppOldObject

IUnknown

ppOldObject

);

#define COM_RIGHTS_EXECUTE 1

#define COM_RIGHTS_EXECUTE_LOCAL 2

#define COM_RIGHTS_EXECUTE_REMOTE 4

#define COM_RIGHTS_ACTIVATE_LOCAL 8

#define COM_RIGHTS_ACTIVATE_REMOTE 16

#define COM_RIGHTS_RESERVED1 32

#define COM_RIGHTS_RESERVED2 64

#endif // WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_APP | WINAPI_PARTITION_SYSTEM)

#pragma endregion

#endif // DCOM

#pragma region Desktop or OneCore Family

#if WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_DESKTOP | WINAPI_PARTITION_SYSTEM)

/* helper for creating instances */

_Check_return_ WINOLEAPI

extern

"C"

__declspec

(dllimport)

HRESULT

__stdcall

CoCreateInstance

(

_In_ REFCLSID rclsid,

const

IID

rclsid

_In_opt_ LPUNKNOWN pUnkOuter,

LPUNKNOWN

pUnkOuter

_In_ DWORD dwClsContext,

DWORD

dwClsContext

_In_ REFIID riid,

const

IID

riid

_COM_Outptr_ _At_(*ppv, _Post_readable_size_(_Inexpressible_(varies))) LPVOID FAR * ppv

LPVOID

ppv

);

// DCOM

#if (_WIN32_WINNT >= 0x0400) || defined(_WIN32_DCOM)

_Check_return_ WINOLEAPI

extern

"C"

__declspec

(dllimport)

HRESULT

__stdcall

CoCreateInstanceEx

(

_In_ REFCLSID Clsid,

const

IID

Clsid

_In_opt_ IUnknown* punkOuter,

IUnknown

punkOuter

_In_ DWORD dwClsCtx,

DWORD

dwClsCtx

_In_opt_ COSERVERINFO* pServerInfo,

COSERVERINFO

pServerInfo

_In_ DWORD dwCount,

DWORD

dwCount

_Inout_updates_(dwCount) MULTI_QI* pResults

MULTI_QI

pResults

);

#endif // DCOM

WINOLEAPI

extern

"C"

__declspec

(dllimport)

HRESULT

__stdcall

CoRegisterActivationFilter

(

_In_ IActivationFilter* pActivationFilter

IActivationFilter

pActivationFilter

);

#endif // WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_DESKTOP | WINAPI_PARTITION_SYSTEM)

#pragma endregion

#if (_WIN32_WINNT >= 0x0602)

#pragma region Application or OneCore Family

#if WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_APP | WINAPI_PARTITION_SYSTEM)

_Check_return_ WINOLEAPI

extern

"C"

__declspec

(dllimport)

HRESULT

__stdcall

CoCreateInstanceFromApp

(

_In_ REFCLSID Clsid,

const

IID

Clsid

_In_opt_ IUnknown* punkOuter,

IUnknown

punkOuter

_In_ DWORD dwClsCtx,

DWORD

dwClsCtx

_In_opt_ PVOID reserved,

PVOID

reserved

_In_ DWORD dwCount,

DWORD

dwCount

_Inout_updates_(dwCount) MULTI_QI* pResults

MULTI_QI

pResults

);

#endif // WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_APP | WINAPI_PARTITION_SYSTEM)

#pragma endregion

#endif

#pragma region Not Desktop or OneCore Family

#if WINAPI_PARTITION_APP && !(WINAPI_PARTITION_DESKTOP | WINAPI_PARTITION_SYSTEM)

__inline _Check_return_ HRESULT CoCreateInstance(

_In_ REFCLSID rclsid,

_In_opt_ LPUNKNOWN pUnkOuter,

_In_ DWORD dwClsContext,

_In_ REFIID riid,

_COM_Outptr_ _At_(*ppv, _Post_readable_size_(_Inexpressible_(varies))) LPVOID FAR* ppv)

{

MULTI_QI OneQI;

HRESULT hr;

OneQI.pItf = NULL;

#ifdef __cplusplus

OneQI.pIID = &riid;

#else

OneQI.pIID = riid;

#endif

hr = CoCreateInstanceFromApp( rclsid, pUnkOuter, dwClsContext, NULL, 1, &OneQI );

#ifdef _PREFAST_

if (SUCCEEDED(hr) && SUCCEEDED(OneQI.hr))

_Analysis_assume_(OneQI.pItf != NULL);

else

_Analysis_assume_(OneQI.pItf == NULL);

#endif

*ppv = OneQI.pItf;

return FAILED(hr) ? hr : OneQI.hr;

}

__inline _Check_return_ HRESULT CoCreateInstanceEx(

_In_ REFCLSID Clsid,

_In_opt_ IUnknown * punkOuter,

_In_ DWORD dwClsCtx,

_In_opt_ COSERVERINFO * pServerInfo,

_In_ DWORD dwCount,

_Inout_updates_(dwCount) MULTI_QI *pResults )

{

return CoCreateInstanceFromApp(Clsid, punkOuter, dwClsCtx, pServerInfo, dwCount, pResults);

}

#endif // WINAPI_PARTITION_APP && !(WINAPI_PARTITION_DESKTOP | WINAPI_PARTITION_SYSTEM)

#pragma endregion

/* Call related APIs */

// DCOM

#if (_WIN32_WINNT >= 0x0500) || defined(_WIN32_DCOM)

#pragma region Desktop or OneCore Family

#if WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_DESKTOP | WINAPI_PARTITION_SYSTEM)

_Check_return_ WINOLEAPI

extern

"C"

__declspec

(dllimport)

HRESULT

__stdcall

CoGetCancelObject

(

_In_ DWORD dwThreadId,

DWORD

dwThreadId

_In_ REFIID iid,

const

IID

iid

_Outptr_ void** ppUnk

void

ppUnk

);

_Check_return_ WINOLEAPI

extern

"C"

__declspec

(dllimport)

HRESULT

__stdcall

CoSetCancelObject

(

_In_opt_ IUnknown* pUnk

IUnknown

pUnk

);

_Check_return_ WINOLEAPI

extern

"C"

__declspec

(dllimport)

HRESULT

__stdcall

CoCancelCall

(

_In_ DWORD dwThreadId,

DWORD

dwThreadId

_In_ ULONG ulTimeout

ULONG

ulTimeout

);

_Check_return_ WINOLEAPI

extern

"C"

__declspec

(dllimport)

HRESULT

__stdcall

CoTestCancel

(

void

);

_Check_return_ WINOLEAPI

extern

"C"

__declspec

(dllimport)

HRESULT

__stdcall

CoEnableCallCancellation

(

_In_opt_ LPVOID pReserved

LPVOID

pReserved

);

_Check_return_ WINOLEAPI

extern

"C"

__declspec

(dllimport)

HRESULT

__stdcall

CoDisableCallCancellation

(

_In_opt_ LPVOID pReserved

LPVOID

pReserved

);

#endif // WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_DESKTOP | WINAPI_PARTITION_SYSTEM)

#pragma endregion

#endif

#pragma region Application or OneCore Family

#if WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_APP | WINAPI_PARTITION_SYSTEM)

/* other helpers */

_Check_return_ WINOLEAPI

extern

"C"

__declspec

(dllimport)

HRESULT

__stdcall

StringFromCLSID

(

_In_ REFCLSID rclsid,

const

IID

rclsid

_Outptr_ LPOLESTR FAR * lplpsz

LPOLESTR

lplpsz

);

_Check_return_ WINOLEAPI

extern

"C"

__declspec

(dllimport)

HRESULT

__stdcall

CLSIDFromString

(

_In_ LPCOLESTR lpsz,

LPCOLESTR

lpsz

_Out_ LPCLSID pclsid

LPCLSID

pclsid

);

_Check_return_ WINOLEAPI

extern

"C"

__declspec

(dllimport)

HRESULT

__stdcall

StringFromIID

(

_In_ REFIID rclsid,

const

IID

rclsid

_Outptr_ LPOLESTR FAR * lplpsz

LPOLESTR

lplpsz

);

_Check_return_ WINOLEAPI

extern

"C"

__declspec

(dllimport)

HRESULT

__stdcall

IIDFromString

(

_In_ LPCOLESTR lpsz,

LPCOLESTR

lpsz

_Out_ LPIID lpiid

LPIID

lpiid

);

#endif // WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_APP | WINAPI_PARTITION_SYSTEM)

#pragma endregion #pragma region Desktop or OneCore Family

#if WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_DESKTOP | WINAPI_PARTITION_SYSTEM)

_Check_return_ WINOLEAPI

extern

"C"

__declspec

(dllimport)

HRESULT

__stdcall

ProgIDFromCLSID

(

_In_ REFCLSID clsid,

const

IID

clsid

_Outptr_ LPOLESTR FAR * lplpszProgID

LPOLESTR

lplpszProgID

);

_Check_return_ WINOLEAPI

extern

"C"

__declspec

(dllimport)

HRESULT

__stdcall

CLSIDFromProgID

(

_In_ LPCOLESTR lpszProgID,

LPCOLESTR

lpszProgID

_Out_ LPCLSID lpclsid

LPCLSID

lpclsid

);

#endif // WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_DESKTOP | WINAPI_PARTITION_SYSTEM)

#pragma endregion #pragma region Application or OneCore Family

#if WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_APP | WINAPI_PARTITION_SYSTEM)

_Check_return_ WINOLEAPI_(int)

extern

"C"

__declspec

(dllimport)

int

__stdcall

StringFromGUID2

(

_In_ REFGUID rguid,

const

GUID

rguid

_Out_writes_to_(cchMax,return) LPOLESTR lpsz,

LPOLESTR

lpsz

_In_ int cchMax

int

cchMax

);

_Check_return_ WINOLEAPI

extern

"C"

__declspec

(dllimport)

HRESULT

__stdcall

CoCreateGuid

(

_Out_ GUID FAR * pguid

GUID

pguid

);

/* Prop variant support */

typedef

struct

tagPROPVARIANT

PROPVARIANT

;

_Check_return_

WINOLEAPI

extern

"C"

__declspec

(dllimport)

HRESULT

__stdcall

PropVariantCopy

(

_Out_ PROPVARIANT* pvarDest,

PROPVARIANT

pvarDest

_In_ const PROPVARIANT* pvarSrc

const

PROPVARIANT

pvarSrc

);

WINOLEAPI

extern

"C"

__declspec

(dllimport)

HRESULT

__stdcall

PropVariantClear

(

_Inout_ PROPVARIANT* pvar

PROPVARIANT

pvar

);

WINOLEAPI

extern

"C"

__declspec

(dllimport)

HRESULT

__stdcall

FreePropVariantArray

(

_In_ ULONG cVariants,

ULONG

cVariants

_Inout_updates_(cVariants) PROPVARIANT* rgvars

PROPVARIANT

rgvars

);

#endif // WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_APP | WINAPI_PARTITION_SYSTEM)

#pragma endregion

// DCOM

#if (_WIN32_WINNT >= 0x0400) || defined(_WIN32_DCOM)

#pragma region Desktop or OneCore Family

#if WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_DESKTOP | WINAPI_PARTITION_SYSTEM)

#endif // WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_DESKTOP | WINAPI_PARTITION_SYSTEM)

#pragma endregion

#endif // DCOM

// DCOM

#if (_WIN32_WINNT >= 0x0400) || defined(_WIN32_DCOM)

/* Synchronization API */

#pragma region Desktop or OneCore Family

#if WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_DESKTOP | WINAPI_PARTITION_SYSTEM)

_Check_return_ WINOLEAPI

extern

"C"

__declspec

(dllimport)

HRESULT

__stdcall

CoWaitForMultipleHandles

(

_In_ DWORD dwFlags,

DWORD

dwFlags

_In_ DWORD dwTimeout,

DWORD

dwTimeout

_In_ ULONG cHandles,

ULONG

cHandles

_In_reads_(cHandles) LPHANDLE pHandles,

LPHANDLE

pHandles

_Out_ LPDWORD lpdwindex

LPDWORD

lpdwindex

);

/* Flags for Synchronization API and Classes */

typedef

enum

tagCOWAIT_FLAGS

{

COWAIT_DEFAULT

COWAIT_WAITALL

COWAIT_ALERTABLE

COWAIT_INPUTAVAILABLE

COWAIT_DISPATCH_CALLS

COWAIT_DISPATCH_WINDOW_MESSAGES

0x10

, }

COWAIT_FLAGS

;

#if (NTDDI_VERSION >= NTDDI_WIN8)

typedef

enum

CWMO_FLAGS

{

CWMO_DEFAULT

CWMO_DISPATCH_CALLS

CWMO_DISPATCH_WINDOW_MESSAGES

, }

CWMO_FLAGS

;

WINOLEAPI

extern

"C"

__declspec

(dllimport)

HRESULT

__stdcall

CoWaitForMultipleObjects

(

_In_ DWORD dwFlags,

DWORD

dwFlags

_In_ DWORD dwTimeout,

DWORD

dwTimeout

_In_ ULONG cHandles,

ULONG

cHandles

_In_reads_(cHandles) const HANDLE* pHandles,

const

HANDLE

pHandles

_Out_ LPDWORD lpdwindex

LPDWORD

lpdwindex

);

#endif // (NTDDI_VERSION >= NTDDI_WIN8)

#define CWMO_MAX_HANDLES 56

#endif // WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_DESKTOP | WINAPI_PARTITION_SYSTEM)

#pragma endregion

#endif // DCOM

#pragma region Desktop or OneCore Family

#if WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_DESKTOP | WINAPI_PARTITION_SYSTEM)

_Check_return_ WINOLEAPI

extern

"C"

__declspec

(dllimport)

HRESULT

__stdcall

CoGetTreatAsClass

(

_In_ REFCLSID clsidOld,

const

IID

clsidOld

_Out_ LPCLSID pClsidNew

LPCLSID

pClsidNew

);

#endif // WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_DESKTOP | WINAPI_PARTITION_SYSTEM)

#pragma endregion

/* for flushing OLESCM remote binding handles */

#if (_WIN32_WINNT >= 0x0501)

#pragma region Desktop or OneCore Family

#if WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_DESKTOP | WINAPI_PARTITION_SYSTEM)

_Check_return_ WINOLEAPI

extern

"C"

__declspec

(dllimport)

HRESULT

__stdcall

CoInvalidateRemoteMachineBindings

(

_In_ LPOLESTR pszMachineName

LPOLESTR

pszMachineName

);

#endif // WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_DESKTOP | WINAPI_PARTITION_SYSTEM)

#pragma endregion

#endif

#if (NTDDI_VERSION >= NTDDI_WINBLUE)

#pragma region Application or OneCore Family

#if WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_APP | WINAPI_PARTITION_SYSTEM)

enum

AgileReferenceOptions

{

AGILEREFERENCE_DEFAULT

AGILEREFERENCE_DELAYEDMARSHAL

, };

_Check_return_ WINOLEAPI

extern

"C"

__declspec

(dllimport)

HRESULT

__stdcall

RoGetAgileReference

(

_In_ enum AgileReferenceOptions options,

enum

AgileReferenceOptions

options

_In_ REFIID riid,

const

IID

riid

_In_ IUnknown* pUnk,

IUnknown

pUnk

_COM_Outptr_ IAgileReference** ppAgileReference

IAgileReference

ppAgileReference

);

#endif // WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_APP | WINAPI_PARTITION_SYSTEM)

#pragma endregion

#endif

#pragma region Application or OneCore Family

#if WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_APP | WINAPI_PARTITION_SYSTEM)

/* the server dlls must define their DllGetClassObject and DllCanUnloadNow * to match these; the typedefs are located here to ensure all are changed at * the same time. */

typedef HRESULT (STDAPICALLTYPE * LPFNGETCLASSOBJECT) (REFCLSID, REFIID, LPVOID *);

typedef

HRESULT

(

__stdcall

LPFNGETCLASSOBJECT

) (

const

IID

const

IID

LPVOID

*);

typedef HRESULT (STDAPICALLTYPE * LPFNCANUNLOADNOW)(void);

typedef

HRESULT

(

__stdcall

LPFNCANUNLOADNOW

)(

void

);

_Check_return_

STDAPI DllGetClassObject(_In_ REFCLSID rclsid, _In_ REFIID riid, _Outptr_ LPVOID FAR* ppv);

extern

"C"

HRESULT

__stdcall

DllGetClassObject

(

const

IID

rclsid

const

IID

riid

LPVOID

ppv

);

__control_entrypoint(DllExport)

STDAPI DllCanUnloadNow(void);

extern

"C"

HRESULT

__stdcall

DllCanUnloadNow

(

void

);

/****** Default Memory Allocation ******************************************/

WINOLEAPI_(_Ret_opt_ _Post_writable_byte_size_(cb) __drv_allocatesMem(Mem) _Check_return_ LPVOID)

extern

"C"

__declspec

(dllimport)

LPVOID

__stdcall

CoTaskMemAlloc

(

_In_ SIZE_T cb

SIZE_T

);

WINOLEAPI_(_Ret_opt_ _Post_writable_byte_size_(cb) _When_(cb > 0, __drv_allocatesMem(Mem) _Check_return_) LPVOID)

extern

"C"

__declspec

(dllimport)

LPVOID

__stdcall

CoTaskMemRealloc

(

_Pre_maybenull_ __drv_freesMem(Mem) _Post_invalid_ LPVOID pv,

LPVOID

_In_ SIZE_T cb

SIZE_T

);

WINOLEAPI_(void)

extern

"C"

__declspec

(dllimport)

void

__stdcall

CoTaskMemFree

(

_Frees_ptr_opt_ LPVOID pv

LPVOID

);

#endif // WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_APP | WINAPI_PARTITION_SYSTEM)

#pragma endregion #pragma region Desktop or OneCore Family

#if WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_DESKTOP | WINAPI_PARTITION_SYSTEM)

WINOLEAPI

extern

"C"

__declspec

(dllimport)

HRESULT

__stdcall

CoFileTimeNow

(

_Out_ FILETIME FAR * lpFileTime

FILETIME

lpFileTime

);

_Check_return_ WINOLEAPI

extern

"C"

__declspec

(dllimport)

HRESULT

__stdcall

CLSIDFromProgIDEx

(

_In_ LPCOLESTR lpszProgID,

LPCOLESTR

lpszProgID

_Out_ LPCLSID lpclsid

LPCLSID

lpclsid

);

#endif // WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_DESKTOP | WINAPI_PARTITION_SYSTEM)

#pragma endregion

#ifndef RC_INVOKED #include <poppack.h> #endif // RC_INVOKED

#endif // __COMBASEAPI_H__