dlls/ole32/dcom.idl - wine - Git at Google


            
            /*

            
             * Copyright 2003 Ove Kåven, TransGaming Technologies

            
             *

            
             * This library is free software; you can redistribute it and/or

            
             * modify it under the terms of the GNU Lesser General Public

            
             * License as published by the Free Software Foundation; either

            
             * version 2.1 of the License, or (at your option) any later version.

            
             *

            
             * This library is distributed in the hope that it will be useful,

            
             * but WITHOUT ANY WARRANTY; without even the implied warranty of

            
             * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU

            
             * Lesser General Public License for more details.

            
             *

            
             * You should have received a copy of the GNU Lesser General Public

            
             * License along with this library; if not, write to the Free Software

            
             * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA

            
             */


            /* see the official DCOM specification

            
             * (there's a copy at http://www.grimes.demon.co.uk/DCOM/DCOMSpec.htm) */


            #pragma makedep proxy

            
            #pragma makedep register


            import "unknwn.idl";


            [

            
                threading(both),

            
                uuid(00000320-0000-0000-c000-000000000046)

            
            ]

            
            coclass PSFactoryBuffer { interface IFactoryBuffer; }


            [

            
              uuid(99fcfe60-5260-101b-bbcb-00aa0021347a),

            
              pointer_default(unique)

            
            ]

            
            interface ObjectRpcBaseTypes

            
            {

            
              typedef unsigned hyper ID;

            
              typedef ID MID;

            
              typedef ID OXID;

            
              typedef ID OID;

            
              typedef ID SETID;

            
              typedef GUID IPID;

            
              typedef GUID CID;

            
              typedef REFGUID REFIPID;


              const unsigned short COM_MINOR_VERSION_1 = 1;

            
              const unsigned short COM_MINOR_VERSION_2 = 2;


              const unsigned short COM_MAJOR_VERSION = 5;

            
              const unsigned short COM_MINOR_VERSION = 3;


              typedef struct tagCOMVERSION {

            
                unsigned short MajorVersion;

            
                unsigned short MinorVersion;

            
              } COMVERSION;


              const unsigned long ORPCF_NULL = 0;

            
              const unsigned long ORPCF_LOCAL = 1;

            
              const unsigned long ORPCF_RESERVED1 = 2;

            
              const unsigned long ORPCF_RESERVED2 = 4;

            
              const unsigned long ORPCF_RESERVED3 = 8;

            
              const unsigned long ORPCF_RESERVED4 = 16;


              typedef struct tagORPC_EXTENT {

            
                GUID id;

            
                unsigned long size;

            
                [size_is((size+7)&~7)] byte data[];

            
              } ORPC_EXTENT;


              typedef struct tagORPC_EXTENT_ARRAY {

            
                unsigned long size;

            
                unsigned long reserved;

            
                [size_is((size+1)&~1,), unique] ORPC_EXTENT **extent;

            
              } ORPC_EXTENT_ARRAY;


              typedef struct tagORPCTHIS {

            
                COMVERSION version;

            
                unsigned long flags;

            
                unsigned long reserved1;

            
                CID cid;

            
                [unique] ORPC_EXTENT_ARRAY *extensions;

            
              } ORPCTHIS;


              typedef struct tagORPCTHAT {

            
                unsigned long flags;

            
                [unique] ORPC_EXTENT_ARRAY *extensions;

            
              } ORPCTHAT;


              const unsigned short NCADG_IP_UDP = 0x08;

            
              const unsigned short NCACN_IP_TCP = 0x07;

            
              const unsigned short NCADG_IPX = 0x0E;

            
              const unsigned short NCACN_SPX = 0x0C;

            
              const unsigned short NCACN_NB_NB = 0x12;

            
              const unsigned short NCACN_NB_IPX = 0x0D;

            
              const unsigned short NCACN_DNET_NSP = 0x04;

            
              const unsigned short NCACN_HTTP = 0x1F;


              typedef struct tagSTRINGBINDING {

            
                unsigned short wTowerId;

            
                [string] WCHAR aNetworkAddr[];

            
              } STRINGBINDING;


              const unsigned short COM_C_AUTHZ_NONE = 0xffff;


              typedef struct tagSECURITYBINDING {

            
                unsigned short wAuthnSvc;

            
                unsigned short wAuthzSvc;

            
                [string] WCHAR aPrincName[];

            
              } SECURITYBINDING;


              typedef struct tagDUALSTRINGARRAY {

            
                unsigned short wNumEntries;

            
                unsigned short wSecurityOffset;

            
                [size_is(wNumEntries)] unsigned short aStringArray[];

            
              } DUALSTRINGARRAY;


              typedef struct tagOXID_INFO {

            
                DWORD dwTid;

            
                DWORD dwPid;

            
                IPID ipidRemUnknown;

            
                DWORD dwAuthnHint;

            
                DUALSTRINGARRAY *psa;

            
              } OXID_INFO;


              const unsigned long OBJREF_SIGNATURE = 0x574f454d; /* "MEOW" */

            
              const unsigned long OBJREF_STANDARD = 0x1;

            
              const unsigned long OBJREF_HANDLER = 0x2;

            
              const unsigned long OBJREF_CUSTOM = 0x4;

            
              const unsigned long SORF_OXRES1 = 0x1;

            
              const unsigned long SORF_OXRES2 = 0x20;

            
              const unsigned long SORF_OXRES3 = 0x40;

            
              const unsigned long SORF_OXRES4 = 0x80;

            
              const unsigned long SORF_OXRES5 = 0x100;

            
              const unsigned long SORF_OXRES6 = 0x200;

            
              const unsigned long SORF_OXRES7 = 0x400;

            
              const unsigned long SORF_OXRES8 = 0x800;

            
              const unsigned long SORF_NULL = 0x0;

            
              const unsigned long SORF_NOPING = 0x1000;


              typedef struct tagSTDOBJREF {

            
                unsigned long flags;

            
                unsigned long cPublicRefs;

            
                OXID oxid;

            
                OID oid;

            
                IPID ipid;

            
              } STDOBJREF;


              typedef struct tagOBJREF {

            
                unsigned long signature;

            
                unsigned long flags;

            
                GUID iid;

            
                [switch_is(flags)] union {

            
                [case(OBJREF_STANDARD)] struct OR_STANDARD {

            
                    STDOBJREF std;

            
                    DUALSTRINGARRAY saResAddr;

            
                  } u_standard;

            
                [case(OBJREF_HANDLER)] struct OR_HANDLER {

            
                    STDOBJREF std;

            
                    CLSID clsid;

            
                    DUALSTRINGARRAY saResAddr;

            
                  } u_handler;

            
                [case(OBJREF_CUSTOM)] struct OR_CUSTOM {

            
                    CLSID clsid;

            
                    unsigned long cbExtension;

            
                    ULONG size;

            
                    [size_is(size), ref] byte *pData;

            
                  } u_custom;

            
                } u_objref;

            
              } OBJREF;


              typedef struct tagMInterfacePointer {

            
                ULONG ulCntData;

            
                [size_is(ulCntData)] BYTE abData[];

            
              } MInterfacePointer;


              typedef [unique] MInterfacePointer *PMInterfacePointer;


            } /* interface ObjectRpcBaseTypes */


            [

            
              object,

            
              uuid(00000131-0000-0000-C000-000000000046)

            
            ]

            
            interface IRemUnknown : IUnknown

            
            {

            
              typedef [unique] IRemUnknown *LPREMUNKNOWN;


              typedef struct tagREMQIRESULT {

            
                HRESULT hResult;

            
                STDOBJREF std;

            
              } REMQIRESULT;


              typedef struct tagREMINTERFACEREF {

            
                IPID ipid;

            
                unsigned long cPublicRefs;

            
                unsigned long cPrivateRefs;

            
              } REMINTERFACEREF;


              HRESULT RemQueryInterface(

            
                [in] REFIPID ripid,

            
                [in] ULONG cRefs,

            
                [in] unsigned short cIids,

            
                [in, size_is(cIids)] IID *iids,

            
                [out, size_is(,cIids)] REMQIRESULT **ppQIResults);


              HRESULT RemAddRef(

            
                [in] unsigned short cInterfaceRefs,

            
                [in, size_is(cInterfaceRefs)] REMINTERFACEREF* InterfaceRefs,

            
                [out, size_is(cInterfaceRefs)] HRESULT *pResults);


              HRESULT RemRelease(

            
                [in] unsigned short cInterfaceRefs,

            
                [in, size_is(cInterfaceRefs)] REMINTERFACEREF* InterfaceRefs);

            
            }


            [

            
              object,

            
              uuid(00000142-0000-0000-C000-000000000046)

            
            ]

            
            interface IRemUnknown2 : IRemUnknown

            
            {

            
              typedef [unique] IRemUnknown2 *LPREMUNKNOWN2;


              HRESULT RemQueryInterface2(

            
                [in] REFIPID ripid,

            
                [in] unsigned short cIids,

            
                [in, size_is(cIids)] IID *iids,

            
                [out, size_is(cIids)] HRESULT *phr,

            
                [out, size_is(cIids)] MInterfacePointer **ppMIF);

            
            }


            [

            
              uuid(99fcfec4-5260-101b-bbcb-00aa0021347a),

            
              pointer_default(unique)

            
            ]

            
            interface IOXIDResolver

            
            {

            
              [idempotent] error_status_t ResolveOxid(

            
                [in] handle_t hRpc,

            
                [in] OXID *pOxid,

            
                [in] unsigned short cRequestedProtseqs,

            
                [in, ref, size_is(cRequestedProtseqs)] unsigned short arRequestedProtseqs[],

            
                [out, ref] DUALSTRINGARRAY **ppdsaOxidBindings,

            
                [out, ref] IPID *pipidRemUnknown,

            
                [out, ref] DWORD *pAuthnHint);


              [idempotent] error_status_t SimplePing(

            
                [in] handle_t hRpc,

            
                [in] SETID *pSetId);


              [idempotent] error_status_t ComplexPing(

            
                [in] handle_t hRpc,

            
                [in, out] SETID *pSetId,

            
                [in] unsigned short SequenceNum,

            
                [in] unsigned short cAddToSet,

            
                [in] unsigned short cDelFromSet,

            
                [in, unique, size_is(cAddToSet)] OID AddToSet[],

            
                [in, unique, size_is(cDelFromSet)] OID DelFromSet[],

            
                [out] unsigned short *pPingBackoffFactor);


              [idempotent] error_status_t ServerAlive(

            
                [in] handle_t hRpc);


              [idempotent] error_status_t ResolveOxid2(

            
                [in] handle_t hRpc,

            
                [in] OXID *pOxid,

            
                [in] unsigned short cRequestedProtseqs,

            
                [in, ref, size_is(cRequestedProtseqs)] unsigned short arRequestedProtseqs[],

            
                [out, ref] DUALSTRINGARRAY **ppdsaOxidBindings,

            
                [out, ref] IPID *pipidRemUnknown,

            
                [out, ref] DWORD *pAuthnHint,

            
                [out, ref] COMVERSION *pComVersion);

            
            }


            [

            
              uuid(4d9f4ab8-7d1c-11cf-861e-0020af6e7c57),

            
              pointer_default(unique)

            
            ]

            
            interface IRemoteActivation

            
            {

            
              const unsigned long MODE_GET_CLASS_OBJECT = 0xffffffff;


              HRESULT RemoteActivation(

            
                [in] handle_t hRpc,

            
                [in] ORPCTHIS *ORPCthis,

            
                [out] ORPCTHAT *ORPCthat,

            
                [in] 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 RequestedProtseqs[],

            
                [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);

            
            }
	/*
	* Copyright 2003 Ove Kåven, TransGaming Technologies
	*
	* This library is free software; you can redistribute it and/or
	* modify it under the terms of the GNU Lesser General Public
	* License as published by the Free Software Foundation; either
	* version 2.1 of the License, or (at your option) any later version.
	*
	* This library is distributed in the hope that it will be useful,
	* but WITHOUT ANY WARRANTY; without even the implied warranty of
	* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
	* Lesser General Public License for more details.
	*
	* You should have received a copy of the GNU Lesser General Public
	* License along with this library; if not, write to the Free Software
	* Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA
	*/

	/* see the official DCOM specification
	* (there's a copy at http://www.grimes.demon.co.uk/DCOM/DCOMSpec.htm) */

	#pragma makedep proxy
	#pragma makedep register

	import "unknwn.idl";

	[
	threading(both),
	uuid(00000320-0000-0000-c000-000000000046)
	]
	coclass PSFactoryBuffer { interface IFactoryBuffer; }

	[
	uuid(99fcfe60-5260-101b-bbcb-00aa0021347a),
	pointer_default(unique)
	]
	interface ObjectRpcBaseTypes
	{
	typedef unsigned hyper ID;
	typedef ID MID;
	typedef ID OXID;
	typedef ID OID;
	typedef ID SETID;
	typedef GUID IPID;
	typedef GUID CID;
	typedef REFGUID REFIPID;

	const unsigned short COM_MINOR_VERSION_1 = 1;
	const unsigned short COM_MINOR_VERSION_2 = 2;

	const unsigned short COM_MAJOR_VERSION = 5;
	const unsigned short COM_MINOR_VERSION = 3;

	typedef struct tagCOMVERSION {
	unsigned short MajorVersion;
	unsigned short MinorVersion;
	} COMVERSION;

	const unsigned long ORPCF_NULL = 0;
	const unsigned long ORPCF_LOCAL = 1;
	const unsigned long ORPCF_RESERVED1 = 2;
	const unsigned long ORPCF_RESERVED2 = 4;
	const unsigned long ORPCF_RESERVED3 = 8;
	const unsigned long ORPCF_RESERVED4 = 16;

	typedef struct tagORPC_EXTENT {
	GUID id;
	unsigned long size;
	[size_is((size+7)&~7)] byte data[];
	} ORPC_EXTENT;

	typedef struct tagORPC_EXTENT_ARRAY {
	unsigned long size;
	unsigned long reserved;
	[size_is((size+1)&~1,), unique] ORPC_EXTENT **extent;
	} ORPC_EXTENT_ARRAY;

	typedef struct tagORPCTHIS {
	COMVERSION version;
	unsigned long flags;
	unsigned long reserved1;
	CID cid;
	[unique] ORPC_EXTENT_ARRAY *extensions;
	} ORPCTHIS;

	typedef struct tagORPCTHAT {
	unsigned long flags;
	[unique] ORPC_EXTENT_ARRAY *extensions;
	} ORPCTHAT;

	const unsigned short NCADG_IP_UDP = 0x08;
	const unsigned short NCACN_IP_TCP = 0x07;
	const unsigned short NCADG_IPX = 0x0E;
	const unsigned short NCACN_SPX = 0x0C;
	const unsigned short NCACN_NB_NB = 0x12;
	const unsigned short NCACN_NB_IPX = 0x0D;
	const unsigned short NCACN_DNET_NSP = 0x04;
	const unsigned short NCACN_HTTP = 0x1F;

	typedef struct tagSTRINGBINDING {
	unsigned short wTowerId;
	[string] WCHAR aNetworkAddr[];
	} STRINGBINDING;

	const unsigned short COM_C_AUTHZ_NONE = 0xffff;

	typedef struct tagSECURITYBINDING {
	unsigned short wAuthnSvc;
	unsigned short wAuthzSvc;
	[string] WCHAR aPrincName[];
	} SECURITYBINDING;

	typedef struct tagDUALSTRINGARRAY {
	unsigned short wNumEntries;
	unsigned short wSecurityOffset;
	[size_is(wNumEntries)] unsigned short aStringArray[];
	} DUALSTRINGARRAY;

	typedef struct tagOXID_INFO {
	DWORD dwTid;
	DWORD dwPid;
	IPID ipidRemUnknown;
	DWORD dwAuthnHint;
	DUALSTRINGARRAY *psa;
	} OXID_INFO;

	const unsigned long OBJREF_SIGNATURE = 0x574f454d; /* "MEOW" */
	const unsigned long OBJREF_STANDARD = 0x1;
	const unsigned long OBJREF_HANDLER = 0x2;
	const unsigned long OBJREF_CUSTOM = 0x4;
	const unsigned long SORF_OXRES1 = 0x1;
	const unsigned long SORF_OXRES2 = 0x20;
	const unsigned long SORF_OXRES3 = 0x40;
	const unsigned long SORF_OXRES4 = 0x80;
	const unsigned long SORF_OXRES5 = 0x100;
	const unsigned long SORF_OXRES6 = 0x200;
	const unsigned long SORF_OXRES7 = 0x400;
	const unsigned long SORF_OXRES8 = 0x800;
	const unsigned long SORF_NULL = 0x0;
	const unsigned long SORF_NOPING = 0x1000;

	typedef struct tagSTDOBJREF {
	unsigned long flags;
	unsigned long cPublicRefs;
	OXID oxid;
	OID oid;
	IPID ipid;
	} STDOBJREF;

	typedef struct tagOBJREF {
	unsigned long signature;
	unsigned long flags;
	GUID iid;
	[switch_is(flags)] union {
	[case(OBJREF_STANDARD)] struct OR_STANDARD {
	STDOBJREF std;
	DUALSTRINGARRAY saResAddr;
	} u_standard;
	[case(OBJREF_HANDLER)] struct OR_HANDLER {
	STDOBJREF std;
	CLSID clsid;
	DUALSTRINGARRAY saResAddr;
	} u_handler;
	[case(OBJREF_CUSTOM)] struct OR_CUSTOM {
	CLSID clsid;
	unsigned long cbExtension;
	ULONG size;
	[size_is(size), ref] byte *pData;
	} u_custom;
	} u_objref;
	} OBJREF;

	typedef struct tagMInterfacePointer {
	ULONG ulCntData;
	[size_is(ulCntData)] BYTE abData[];
	} MInterfacePointer;

	typedef [unique] MInterfacePointer *PMInterfacePointer;

	} /* interface ObjectRpcBaseTypes */

	[
	object,
	uuid(00000131-0000-0000-C000-000000000046)
	]
	interface IRemUnknown : IUnknown
	{
	typedef [unique] IRemUnknown *LPREMUNKNOWN;

	typedef struct tagREMQIRESULT {
	HRESULT hResult;
	STDOBJREF std;
	} REMQIRESULT;

	typedef struct tagREMINTERFACEREF {
	IPID ipid;
	unsigned long cPublicRefs;
	unsigned long cPrivateRefs;
	} REMINTERFACEREF;

	HRESULT RemQueryInterface(
	[in] REFIPID ripid,
	[in] ULONG cRefs,
	[in] unsigned short cIids,
	[in, size_is(cIids)] IID *iids,
	[out, size_is(,cIids)] REMQIRESULT **ppQIResults);

	HRESULT RemAddRef(
	[in] unsigned short cInterfaceRefs,
	[in, size_is(cInterfaceRefs)] REMINTERFACEREF* InterfaceRefs,
	[out, size_is(cInterfaceRefs)] HRESULT *pResults);

	HRESULT RemRelease(
	[in] unsigned short cInterfaceRefs,
	[in, size_is(cInterfaceRefs)] REMINTERFACEREF* InterfaceRefs);
	}

	[
	object,
	uuid(00000142-0000-0000-C000-000000000046)
	]
	interface IRemUnknown2 : IRemUnknown
	{
	typedef [unique] IRemUnknown2 *LPREMUNKNOWN2;

	HRESULT RemQueryInterface2(
	[in] REFIPID ripid,
	[in] unsigned short cIids,
	[in, size_is(cIids)] IID *iids,
	[out, size_is(cIids)] HRESULT *phr,
	[out, size_is(cIids)] MInterfacePointer **ppMIF);
	}

	[
	uuid(99fcfec4-5260-101b-bbcb-00aa0021347a),
	pointer_default(unique)
	]
	interface IOXIDResolver
	{
	[idempotent] error_status_t ResolveOxid(
	[in] handle_t hRpc,
	[in] OXID *pOxid,
	[in] unsigned short cRequestedProtseqs,
	[in, ref, size_is(cRequestedProtseqs)] unsigned short arRequestedProtseqs[],
	[out, ref] DUALSTRINGARRAY **ppdsaOxidBindings,
	[out, ref] IPID *pipidRemUnknown,
	[out, ref] DWORD *pAuthnHint);

	[idempotent] error_status_t SimplePing(
	[in] handle_t hRpc,
	[in] SETID *pSetId);

	[idempotent] error_status_t ComplexPing(
	[in] handle_t hRpc,
	[in, out] SETID *pSetId,
	[in] unsigned short SequenceNum,
	[in] unsigned short cAddToSet,
	[in] unsigned short cDelFromSet,
	[in, unique, size_is(cAddToSet)] OID AddToSet[],
	[in, unique, size_is(cDelFromSet)] OID DelFromSet[],
	[out] unsigned short *pPingBackoffFactor);

	[idempotent] error_status_t ServerAlive(
	[in] handle_t hRpc);

	[idempotent] error_status_t ResolveOxid2(
	[in] handle_t hRpc,
	[in] OXID *pOxid,
	[in] unsigned short cRequestedProtseqs,
	[in, ref, size_is(cRequestedProtseqs)] unsigned short arRequestedProtseqs[],
	[out, ref] DUALSTRINGARRAY **ppdsaOxidBindings,
	[out, ref] IPID *pipidRemUnknown,
	[out, ref] DWORD *pAuthnHint,
	[out, ref] COMVERSION *pComVersion);
	}

	[
	uuid(4d9f4ab8-7d1c-11cf-861e-0020af6e7c57),
	pointer_default(unique)
	]
	interface IRemoteActivation
	{
	const unsigned long MODE_GET_CLASS_OBJECT = 0xffffffff;

	HRESULT RemoteActivation(
	[in] handle_t hRpc,
	[in] ORPCTHIS *ORPCthis,
	[out] ORPCTHAT *ORPCthat,
	[in] 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 RequestedProtseqs[],
	[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);
	}