r6973: Merge new version of pidl into the main SAMBA_4_0 branch.
[sfrench/samba-autobuild/.git] / source4 / librpc / idl / dcom.idl
index c7a714a488924f43d9fc1555ca87420f5004f75e..f8db720817b8490bdb84cb4004ed65313a8cdbc7 100644 (file)
 
 [
        uuid("18f70770-8e64-11cf-9af1-0020af6e72f4"),
+       pointer_default(unique),
+       pointer_default_top(unique),
        version(0.0)
 ] interface dcom_Unknown
 {
-       void dcomu_UseProtSeq();
-       void dcomu_GetCustomProtseqInfo();
-       void dcomu_UpdateResolverBindings();
+       void UseProtSeq();
+       void GetCustomProtseqInfo();
+       void UpdateResolverBindings();
 }
 
-[
-       uuid("99fcfe60-5260-101b-bbcb-00aa0021347a"),
-       pointer_default(unique)
-]
-interface ObjectRpcBaseTypes
-{
-       WERROR stub();
-       
-       /* Machine Identifier */
-#define MID HYPER_T
-
-       /* Object Exporter Identifier */
-#define OXID HYPER_T
-       
-       /* Object Identifer */
-#define OID HYPER_T
-       
-       /* Interface Pointer Identifier */
-#define IPID GUID
-       
-       /* Causality Identifier */
-#define CID GUID
-
-       /* Interface identifier */
-#define IID GUID
-
-#define LCID uint32
-
-#define DISPID uint32
-
-       /*//////////////////////////////////////////////////////////////// */
-       /* ORPC Call Packet Format */
-       /*//////////////////////////////////////////////////////////////// */
-       /* COM_MINOR_VERSION = 1 (NT4.0, SP1, SP2, DCOM95). */
-       /* - Initial Release */
-       /* - Must be used when talking to downlevel machines, including */
-       /* on Remote Activation calls. */
-       /* COM_MINOR_VERSION = 2 (NT4.0 SP3 and beyond). */
-       /* - Added ResolveOxid2 to IObjectExporter to retrieve the */
-       /* COM version number of the server. Passed to the NDR engine */
-       /* to fix fatal endian-ness flaw in the way OLEAUTOMATION marshals */
-       /* BSTRS. Previous way used trailing padding, which is not NDR */
-       /* compatible. See Bug# 69189. */
-       /* COM_MINOR_VERSION = 3 (NT4.0 SP4 and DCOM95 builds 1018 and beyond) */
-       /* - OLEAUT32 added two new types to the SAFEARRAY, but SAFEARRAY */
-       /* previously included the "default" keyword, which prevented */
-       /* downlevel NDR engines from correctly handling any extensions. */
-       /* Machines with version >=5.3 don't use "default" and will */
-       /* gracefully handle future extensions to SAFEARRAY. */
-       /* old constants (for convenience) */
-
-       /* current version */
-       const uint16 COM_MAJOR_VERSION = 5;
-       const uint16 COM_MINOR_VERSION = 6;
-
-       /* Body Extensions */
-       const string dcom_ext_debugging = "f1f19680-4d2a-11ce-a66a-0020af6e72f4";
-       const string dcom_ext_extended_error = "f1f19681-4d2a-11ce-a66a-0020af6e72f4";
-
-       /* Component Object Model version number */
-
-       typedef [public] struct 
-       {
-               uint16 MajorVersion; /* Major version number */
-               uint16 MinorVersion; /* Minor version number */
-       } COMVERSION;
-
-       typedef [public] struct 
-       {
-               uint32 reserved1;
-               uint32 reserved2;
-       } COSERVERINFO;
-
-       typedef [public] struct
-       {
-               uint32 FIXME;
-       } MULTI_QI;
-
-       /* enumeration of additional information present in the call packet. */
-       /* Should be an enum but DCE IDL does not support sparse enumerators. */
-       typedef enum {
-               ORPCF_NULL = 0, /* no additional info in packet */
-               ORPCF_LOCAL = 1, /* call is local to this machine */
-               ORPCF_RESERVED1 = 2, /* reserved for local use */
-               ORPCF_RESERVED2 = 4, /* reserved for local use */
-               ORPCF_RESERVED3 = 8, /* reserved for local use */
-               ORPCF_RESERVED4 = 16 /* reserved for local use */
-       } ORPC_FLAGS;
-
-       /* Extension to implicit parameters. */
-       typedef [public] struct 
-       {       
-               GUID id; /* Extension identifier. */
-               uint32 size; /* Extension size. */
-               /*FIXME[size_is((size+7)&~7)] uint8 data[]; // Extension data. */
-               [size_is(size)] uint8 data[];
-       }       ORPC_EXTENT;
-
-
-       /* Array of extensions. */
-       typedef struct 
-       {
-               uint32 size; /* Num extents. */
-               uint32 reserved; /* Must be zero. */
-               /*FIXME[size_is((size+1)&~1,), unique] ORPC_EXTENT **extent; // extents */
-               [size_is(size),unique] ORPC_EXTENT extent[];
-       } ORPC_EXTENT_ARRAY;
-
-
-       /* implicit 'this' pointer which is the first [in] parameter on */
-       /* every ORPC call. */
-       typedef [public] struct 
-       {
-               COMVERSION version; /* COM version number */
-               uint32 flags; /* ORPCF flags for presence of other data */
-               uint32 reserved1; /* set to zero */
-               CID cid; /* causality id of caller */
-               /* Extensions. */
-               [unique] ORPC_EXTENT_ARRAY *extensions;
-       }       ORPCTHIS;
-
-
-       /* implicit 'that' pointer which is the first [out] parameter on */
-       /* every ORPC call. */
-       typedef [public] struct 
-       {
-               uint32 flags; /* ORPCF flags for presence of other data */
-               /* Extensions. */
-               [unique] ORPC_EXTENT_ARRAY *extensions;
-       }       ORPCTHAT;
-
-
-       /* DUALSTRINGARRAYS are the return type for arrays of network addresses, */
-       /* arrays of endpoints and arrays of both used in many ORPC interfaces */
-       typedef struct 
-       {
-               uint16 wTowerId; /* Cannot be zero. */
-               uint16 aNetworkAddr; /* Zero terminated. */
-       }       STRINGBINDING;
-
-
-       const uint16 COM_C_AUTHZ_NONE = 0xffff;
-       typedef struct 
-       {
-               uint16 wAuthnSvc; /* Cannot be zero. */
-               uint16 wAuthzSvc; /* Must not be zero. */
-               uint16 aPrincName; /* Zero terminated. */
-       }       SECURITYBINDING;
-
-
-       typedef [public] struct 
-       {
-               uint16 wNumEntries; /* Number of entries in array. */
-               uint16 wSecurityOffset; /* Offset of security info. */
-               /* The array contains two parts, a set of STRINGBINDINGs */
-               /* and a set of SECURITYBINDINGs. Each set is terminated by an */
-               /* extra zero. The shortest array contains four zeros. */
-               [size_is(wNumEntries)] uint16 aStringArray[];
-       }       DUALSTRINGARRAY;
-
-
-       /* signature value for OBJREF (object reference, actually the */
-       /* marshaled form of a COM interface). */
-       const uint32 OBJREF_SIGNATURE = 0x574f454d; /* 'MEOW' */
-
-       /* flag values for OBJREF */
-       typedef enum {
-               OBJREF_NULL = 0x0, /* NULL pointer */
-               OBJREF_STANDARD = 0x1, /* standard marshaled objref */
-               OBJREF_HANDLER = 0x2, /* handler marshaled objref */
-               OBJREF_CUSTOM = 0x4 /* custom marshaled objref */
-       } OBJREF_FLAGS;
-
-       /* Flag values for a STDOBJREF (standard part of an OBJREF). */
-       /* SORF_OXRES1 - SORF_OXRES8 are reserved for the object exporters */
-       /* use only, object importers must ignore them and must not enforce MBZ. */
-       typedef enum {
-               SORF_NULL   = 0x0000, /* convenient for initializing SORF */
-               SORF_OXRES1 = 0x0001, /* reserved for exporter */
-               SORF_OXRES2 = 0x0020, /* reserved for exporter */
-               SORF_OXRES3 = 0x0040, /* reserved for exporter */
-               SORF_OXRES4 = 0x0080, /* reserved for exporter */
-               SORF_OXRES5 = 0x0100, /* reserved for exporter */
-               SORF_OXRES6 = 0x0200, /* reserved for exporter */
-               SORF_OXRES7 = 0x0400, /* reserved for exporter */
-               SORF_OXRES8 = 0x0800, /* reserved for exporter */
-               SORF_NOPING = 0x1000  /* Pinging is not required  */
-       } STDOBJREF_FLAGS;
-
-       /* standard object reference */
-       typedef [public] struct 
-       {
-               uint32 flags; /* STDOBJREF flags (see above) */
-               uint32 cPublicRefs; /* count of references passed */
-               OXID oxid; /* oxid of server with this oid */
-               OID oid; /* oid of object with this ipid */
-               IPID ipid; /* ipid of Interface */
-       }       STDOBJREF;
-
-       typedef struct
-       {
-               STDOBJREF std; /* standard objref */
-               DUALSTRINGARRAY saResAddr; /* resolver address */
-       } u_standard;
-
-       typedef struct
-       {
-               STDOBJREF std; /* standard objref */
-               GUID clsid; /* Clsid of handler code */
-               DUALSTRINGARRAY saResAddr; /* resolver address */
-       } u_handler;
-
-       typedef struct
-       {
-               GUID clsid; /* Clsid of unmarshaling code */
-               uint32 cbExtension; /* size of extension data */
-               uint32 size; /* size of data that follows */
-               [size_is(size), ref] uint8 *pData; /* extension + class specific data */
-       } u_custom;
-
-       typedef struct
-       {
-       } u_null;
-
-       typedef [nodiscriminant] union 
-       {
-               [case(OBJREF_NULL)] u_null u_null;
-               [case(OBJREF_STANDARD)] u_standard u_standard;
-               [case(OBJREF_HANDLER)] u_handler u_handler;
-               [case(OBJREF_CUSTOM)] u_custom u_custom;
-       } OBJREF_Types;
-
-       /* OBJREF is the format of a marshaled interface pointer. */
-       typedef [public] struct 
-       {
-               uint32 signature;
-               uint32 flags; /* OBJREF flags (see above) */
-               GUID iid; /* interface identifier */
-               [switch_is(flags), switch_type(uint32)] OBJREF_Types u_objref;
-       } OBJREF;
-
-       /* wire representation of a marshalled interface pointer */
-       typedef [public] struct 
-       {
-               uint32 size;
-               [size_is(size)] uint8 data[];
-       } MInterfacePointer;
-}
-
-
 [
        object,
        uuid("00000000-0000-0000-C000-000000000046"),
-       helpstring("Base interface for most COM interfaces")
+       pointer_default(unique),
+       pointer_default_top(unique),
+       helpstring("Base interface for all COM interfaces")
 ]
 interface IUnknown
 {
@@ -278,40 +32,39 @@ interface IUnknown
        /* Function 0x00 */
        /* Returns the interface with the specified IID 
           if implemented by this object */
-       WERROR QueryInterface([in] IID *riid
-          /*FIXME, [out] void **data*/);
+       [local] WERROR QueryInterface([in] GUID *iid,
+          [out,iid_is(riid),ref] IUnknown **data);
 
        /*****************/
        /* Function 0x01 */
-       uint32 AddRef();
+       [local] uint32 AddRef();
 
        /*****************/
        /* Function 0x02 */
-       uint32 Release();
+       [local] uint32 Release();
 }
 
 
 [
        object,
        uuid("00000001-0000-0000-C000-000000000046"),
+       pointer_default_top(unique),
        pointer_default(unique)
 ] interface IClassFactory : IUnknown
 {
-       WERROR CreateInstance(/*FIXME[in] IUnknown *pUnknown, 
-                              [in] IID *riid,
-                              [out, iid_is(riid)] void **ppv*/);
+       [local] WERROR CreateInstance([in] MInterfacePointer *pUnknown, 
+                              [in] GUID *iid,
+                              [out, iid_is(riid)] MInterfacePointer *ppv);
 
-       WERROR RemoteCreateInstance();
+       [call_as(CreateInstance)] WERROR RemoteCreateInstance();
 
        /* Set lock to TRUE when you want to do a lock
        and set it to FALSE when you want to unlock */
-       WERROR LockServer([in] uint8 lock);
+       [local] WERROR LockServer([in] uint8 lock);
 
-       WERROR RemoteLockServer();
+       [call_as(LockServer)] WERROR RemoteLockServer();
 }
 
-/*//////////////////////////////////////////////////////////////// */
-
 /* The remote version of IUnknown. This interface exists on every */
 /* OXID (whether an OXID represents either a thread or a process is */
 /* implementation specific). It is used by clients to query for new */
@@ -322,6 +75,8 @@ interface IUnknown
 [
        uuid("00000131-0000-0000-C000-000000000046"),
        object,
+       pointer_default_top(unique),
+       pointer_default(unique),
        helpstring("Remote version of IUnknown")
 ]
 interface IRemUnknown : IUnknown
@@ -333,28 +88,28 @@ interface IRemUnknown : IUnknown
        }
        REMQIRESULT;
 
-       WERROR RemQueryInterface (
-               [in] IPID *ripid, /* interface to QI on */
+       [call_as(QueryInterface)] WERROR RemQueryInterface (
+               [in] GUID *ripid, /* interface to QI on */
                [in] uint32 cRefs, /* count of AddRefs requested */
                [in] uint16 cIids, /* count of IIDs that follow */
-               [in, size_is(cIids)] IID* iids, /*, // IIDs to QI for */
-                [out] MInterfacePointer *ip
+               [in, size_is(cIids)] GUID *iids[], /* IIDs to QI for */
+               [out, size_is(cIids)] MInterfacePointer *ip[]
                );
 
        typedef struct 
        {
-               IPID ipid; /* ipid to AddRef/Release */
+               GUID ipid; /* ipid to AddRef/Release */
                uint32 cPublicRefs;
                uint32 cPrivateRefs;
        } REMINTERFACEREF;
 
-       WERROR RemAddRef (
+       [call_as(AddRef)] WERROR RemAddRef (
                 [in] uint16 cInterfaceRefs,
                 [in, size_is(cInterfaceRefs)] REMINTERFACEREF InterfaceRefs[],
-                [out, size_is(cInterfaceRefs)] WERROR* pResults
+                [out, size_is(cInterfaceRefs)] WERROR *pResults[]
                );
 
-       WERROR RemRelease (
+       [call_as(Release)] WERROR RemRelease (
                 [in] uint16 cInterfaceRefs,
                 [in, size_is(cInterfaceRefs)] REMINTERFACEREF InterfaceRefs[]
                );
@@ -362,29 +117,61 @@ interface IRemUnknown : IUnknown
 
 [
        uuid("00000140-0000-0000-c000-000000000046"),
+       pointer_default_top(unique),
+       pointer_default(unique),
        object
 ] interface IClassActivator : IUnknown
 {
-       void RemoteGetClassObject([in] GUID clsid, 
-                                                                                         [in] uint32 context,
-                                                                                         [in] LCID locale,
-                                                                                         [in] GUID iid/*FIXME,
-                                                                                         [out, iid_is(iid)] void *data */);
+       void GetClassObject([in] GUID clsid, 
+                               [in] uint32 context,
+                                               [in] uint32 locale,
+                                               [in] GUID iid,
+                                               [out, iid_is(iid)] MInterfacePointer data);
+}
+
+[
+       uuid("00000136-0000-0000-c000-000000000046"),
+       pointer_default_top(unique),
+       pointer_default(unique),
+       object
+] interface ISCMLocalActivator : IClassActivator
+{
+       WERROR ISCMLocalActivator_CreateInstance( );
+}
+
+[
+       pointer_default(unique),
+       pointer_default_top(unique),
+       uuid("c6f3ee72-ce7e-11d1-b71e-00c04fc3111a")
+] interface IMachineLocalActivator 
+{
+       WERROR IMachineLocalActivator_foo();
+}
+
+[
+       pointer_default(unique),
+       pointer_default_top(unique),
+       uuid("e60c73e6-88f9-11cf-9af1-0020af6e72f4")
+] interface ILocalObjectExporter
+{
+       WERROR ILocalObjectExporter_Foo();
 }
 
 /* Looks like this is the equivalent of .NET's 
    System.Activator class */
 [
        uuid("000001a0-0000-0000-c000-000000000046"),
+       pointer_default(unique),
+       pointer_default_top(unique),
        object
 ]
        interface ISystemActivator : IClassActivator
 {
-       WERROR ISystemActivatorRemoteCreateInstance([in] HYPER_T unknown1,  /* IPID ? */
-                                                                                         [in] MInterfacePointer iface,
-                                                                                         [in] HYPER_T unknown2,
+       WERROR ISystemActivatorRemoteCreateInstance([in] hyper unknown1,  /* OXID ? */
+                                                                                         [in] MInterfacePointer iface1,
+                                                                                         [in] hyper unknown2,
                                                                                          [out] uint32 unknown3, 
-                                                                                         [out] MInterfacePointer iface);
+                                                                                         [out] MInterfacePointer iface2);
 }
 
 
@@ -394,31 +181,36 @@ interface IRemUnknown : IUnknown
 /* marshaled interface packets. */
 [
        object,
+       pointer_default(unique),
+       pointer_default_top(unique),
        uuid("00000143-0000-0000-C000-000000000046")
 ]
 
 interface IRemUnknown2 : IRemUnknown
 {
-       WERROR RemQueryInterface2 (
-                [in] IPID *ripid,
+       [call_as(QueryInterface2)] WERROR RemQueryInterface2 (
+                [in] GUID *ripid,
                 [in] uint16 cIids,
-                [in, size_is(cIids)] IID *iids,
-                [out, size_is(cIids)] WERROR *phr,
-                [out, size_is(cIids)] MInterfacePointer *ppMIF
+                [in, size_is(cIids)] GUID *iids[],
+                [out, size_is(cIids)] WERROR *phr[],
+                [out, size_is(cIids)] MInterfacePointer *ppMIF[]
                );
 }
 
 [
-object,
+       object,
+       pointer_default(unique),
+       pointer_default_top(unique),
        uuid("00000136-0000-0000-C000-000000000046")
-       ] interface ISCMActivator : IUnknown
+       ] interface ISCMActivator : IClassActivator
 {
-       WERROR SCMActivator_GetClassObject();
        WERROR SCMActivator_CreateInstance();
 }
 
 [
        object,
+       pointer_default(unique),
+       pointer_default_top(unique),
        uuid("00020400-0000-0000-C000-000000000046")
        ] interface IDispatch : IUnknown
 {
@@ -428,28 +220,23 @@ object,
                        [out] uint16 *pctinfo);
 
        typedef struct {
-               uint8 FIXME;
-       } ITypeInfo;
-
-       typedef struct {
-               ITypeInfo *pTInfo;
        } REF_ITypeInfo;
 
        /*****************/
        /* Function 0x04 */
        WERROR GetTypeInfo (
                        [in] uint16 iTInfo,
-                       [in] LCID lcid,
+                       [in] uint32 lcid,
                        [out] REF_ITypeInfo *ppTInfo);
 
        /*****************/
        /* Function 0x05 */
        WERROR GetIDsOfNames(
-                       [in] IID *riid,
+                       [in] GUID *riid,
                        /*FIXME[in,size_is(cNames)] OLESTR *rgszNames[], */
                        [in] uint16 cNames,
-                       [in] LCID lcid,
-                       [out,size_is(cNames)] DISPID *rgDispId);
+                       [in] uint32 lcid,
+                       [out,size_is(cNames)] uint32 *rgDispId[]);
 
        typedef struct {
                uint16 vartype;
@@ -468,9 +255,9 @@ object,
        /*****************/
        /* Function 0x06 */
        WERROR Invoke(
-                       [in] DISPID dispIdMember,
-                       [in] IID *riid,
-                       [in] LCID lcid,
+                       [in] uint32 dispIdMember,
+                       [in] GUID *riid,
+                       [in] uint32 lcid,
                        [in] uint16 wFlags,
                        [out,in] DISPPARAMS *pDispParams,
                        [out] VARIANT *pVarResult,
@@ -480,9 +267,61 @@ object,
 
 [
        object,
+       local,
        uuid("00000003-0000-0000-C000-000000000046")
 ] interface IMarshal : IUnknown
 {
        WERROR MarshalInterface();
        WERROR UnMarshalInterface();
 }
+
+[
+       uuid(DA23F6DB-6F45-466C-9EED-0B65286F2D78),
+       helpstring("ICoffeeMachine Interface"),
+       pointer_default(unique),
+       pointer_default_top(unique),
+       object
+] interface ICoffeeMachine : IUnknown
+{
+       [helpstring("method MakeCoffee")] WERROR MakeCoffee([in] unistr *flavor);
+}
+
+[
+       uuid("db7c21f8-fe33-4c11-aea5-ceb56f076fbb"),
+       helpstring("coffeemachine class")
+] coclass coffeemachine
+{
+       interface icoffeemachine;
+}
+
+[
+       object,
+       pointer_default(unique),
+       pointer_default_top(unique),
+       uuid("0000000C-0000-0000-C000-000000000046"),
+       helpstring("Stream")
+]
+interface IStream : IUnknown
+{
+       WERROR Read(
+                               [out, size_is(num_requested), length_is(num_read)] uint8 pv[],
+                               [in] uint32 num_requested, 
+                               [in] uint32 *num_readx,
+                               [out] uint32 num_read
+                               );
+
+       WERROR Write(
+                               [in,size_is(num_requested)] uint8 *data[],
+                                [in] uint32 num_requested,
+                                [out] uint32 num_written);
+}
+
+[
+       uuid("5e9ddec7-5767-11cf-beab-00aa006c3606"),
+       progid("Samba.Simple"),
+       helpstring("simple class"),
+       internal
+] coclass simple 
+{
+       interface IStream;
+}