//+-------------------------------------------------------------------------
//
// Microsoft Windows
// Copyright (C) Microsoft Corporation, 1996.
//
// File: remact.idl
//
// Synopsis: Activation interface implemented by object exporters.
//
// This is the interface that needs to be supported by hosts that support
// remote connection requests and export objects. Only one instance of this
// interface can be exported by the host.
//
// Note that this interface is tied closely to IObjectExporter because
// RemoteActivation includes information otherwise retrieved from ResolveOXID.
//
//--------------------------------------------------------------------------
[
uuid(4d9f4ab8-7d1c-11cf-861e-0020af6e7c57),
pointer_default(unique)
]
interface IActivation
{
import "obase.idl";
const unsigned long MODE_GET_CLASS_OBJECT = 0xffffffff;
//
// RemoteActivation is called to request interface pointer data for one or
// more interface IIDs from an object server servicing the given CLSID.
// This could result in the launching of a new instance of the server, or
// connection to an already running instance.
//
// Note that the ResolveOxid parameters are included as well, to prevent
// the necessity for a second RPC during a remote activation. However,
// the client receives the OXID as an out param since it is not known
// before connecting to the server.
//
error_status_t RemoteActivation(
[in] handle_t hRpc,
[in] ORPCTHIS *ORPCthis,
[out] ORPCTHAT *ORPCthat,
[in] const GUID *Clsid,
[in, string, unique] WCHAR *pwszObjectName,
[in, unique] MInterfacePointer *pObjectStorage,
[in] DWORD ClientImpLevel,
[in] DWORD Mode,
[in] DWORD Interfaces,
[in,unique,size_is(Interfaces)] IID *pIIDs,
[in] unsigned short cRequestedProtseqs,
[in, size_is(cRequestedProtseqs)]
unsigned short aRequestedProtseqs[],
[out] OXID *pOxid,
[out] DUALSTRINGARRAY **ppdsaOxidBindings,
[out] IPID *pipidRemUnknown,
[out] DWORD *pAuthnHint,
[out] COMVERSION *pServerVersion,
[out] HRESULT *phr,
[out,size_is(Interfaces)] MInterfacePointer **ppInterfaceData,
[out,size_is(Interfaces)] HRESULT *pResults
);
}
