summaryrefslogtreecommitdiff
path: root/source4/librpc/idl/dcom.idl
diff options
context:
space:
mode:
authorVolker Lendecke <vlendec@samba.org>2004-08-19 13:36:22 +0000
committerGerald (Jerry) Carter <jerry@samba.org>2007-10-10 12:58:11 -0500
commit3ccba74549a66d469eff16a524f012d73a7f8aed (patch)
tree5a38f56ff05a19b54464ec6b442da2d9edf5ff8f /source4/librpc/idl/dcom.idl
parent9d62046b0e09fa7a4a660859dd8651e6d60c8dc8 (diff)
downloadsamba-3ccba74549a66d469eff16a524f012d73a7f8aed.tar.gz
samba-3ccba74549a66d469eff16a524f012d73a7f8aed.tar.bz2
samba-3ccba74549a66d469eff16a524f012d73a7f8aed.zip
r1920: This needs more inspection by the IDL experts. Reverting my last change.
Volker (This used to be commit 5d9b5a2e58cb271ea38de96e2b4b252ded2b1cdf)
Diffstat (limited to 'source4/librpc/idl/dcom.idl')
-rw-r--r--source4/librpc/idl/dcom.idl312
1 files changed, 156 insertions, 156 deletions
diff --git a/source4/librpc/idl/dcom.idl b/source4/librpc/idl/dcom.idl
index b26849f87b..5afeca1e96 100644
--- a/source4/librpc/idl/dcom.idl
+++ b/source4/librpc/idl/dcom.idl
@@ -26,66 +26,66 @@ interface ObjectRpcBaseTypes
{
WERROR stub();
- /* Machine Identifier */
+ // Machine Identifier
#define MID HYPER_T
- /* Object Exporter Identifier */
+ // Object Exporter Identifier
#define OXID HYPER_T
- /* Object Identifer */
+ // Object Identifer
#define OID HYPER_T
- /* Ping Set Identifier */
+ // Ping Set Identifier
#define SETID HYPER_T
- /* Interface Pointer Identifier */
+ // Interface Pointer Identifier
#define IPID GUID
- /* Causality Identifier */
+ // Causality Identifier
#define CID GUID
- /* Class ID */
+ // Class ID
#define CLSID GUID
- /* Interface identifier */
+ // 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) */
+ //////////////////////////////////////////////////////////////////
+ // 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)
const uint16 COM_MINOR_VERSION_1 = 1;
const uint16 COM_MINOR_VERSION_2 = 2;
- /* current version */
+ // current version
const uint16 COM_MAJOR_VERSION = 5;
const uint16 COM_MINOR_VERSION = 3;
- /* Component Object Model version number */
+ // Component Object Model version number
typedef [public] struct
{
- uint16 MajorVersion; /* Major version number */
- uint16 MinorVersion; /* Minor version number */
+ uint16 MajorVersion; // Major version number
+ uint16 MinorVersion; // Minor version number
} COMVERSION;
typedef [public] struct
@@ -99,145 +99,145 @@ interface ObjectRpcBaseTypes
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. */
+ // 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 */
+ 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. */
+ // 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. */
+ 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. */
+ // 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 */
+ 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. */
+ // 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. */
+ 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. */
+ // 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. */
+ 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 */
+ // 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. */
+ 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. */
+ 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. */
+ 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' */
+ // signature value for OBJREF (object reference, actually the
+ // marshaled form of a COM interface).
+ const uint32 OBJREF_SIGNATURE = 0x574f454d; // 'MEOW'
- /* flag values for OBJREF */
+ // flag values for OBJREF
typedef enum {
- OBJREF_STANDARD = 0x1, /* standard marshaled objref */
- OBJREF_HANDLER = 0x2, /* handler marshaled objref */
- OBJREF_CUSTOM = 0x4 /* custom marshaled objref */
+ 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. */
+ // 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 */
+ 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 */
+ // 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 */
+ 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 */
+ STDOBJREF std; // standard objref
+ DUALSTRINGARRAY saResAddr; // resolver address
} u_standard;
typedef struct
{
- STDOBJREF std; /* standard objref */
- CLSID clsid; /* Clsid of handler code */
- DUALSTRINGARRAY saResAddr; /* resolver address */
+ STDOBJREF std; // standard objref
+ CLSID clsid; // Clsid of handler code
+ DUALSTRINGARRAY saResAddr; // resolver address
} u_handler;
typedef struct
{
- CLSID 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 */
+ CLSID 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;
@@ -249,19 +249,19 @@ interface ObjectRpcBaseTypes
[case(OBJREF_CUSTOM)] u_custom u_custom;
} OBJREF_Types;
- /* OBJREF is the format of a marshaled interface pointer. */
+ // OBJREF is the format of a marshaled interface pointer.
typedef struct
{
- uint32 flags; /* OBJREF flags (see above) */
- GUID iid; /* interface identifier */
+ 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 */
+ // wire representation of a marshalled interface pointer
typedef [public] struct
{
- uint32 ulCntData; /* size of data */
- [size_is(ulCntData)] uint8 abData[]; /* data (OBJREF) */
+ uint32 ulCntData; // size of data
+ [size_is(ulCntData)] uint8 abData[]; // data (OBJREF)
} MInterfacePointer;
}
@@ -305,15 +305,15 @@ interface IUnknown
HRESULT 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 */
-/* interfaces, get additional references (for marshaling), and release */
-/* outstanding references. */
-/* This interface is passed along during OXID resolution. */
-/* */
+// 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
+// interfaces, get additional references (for marshaling), and release
+// outstanding references.
+// This interface is passed along during OXID resolution.
+//
[
uuid(00000131-0000-0000-C000-000000000046),
object,
@@ -324,23 +324,23 @@ interface IRemUnknown : IUnknown
{
typedef struct
{
- HRESULT hResult; /* result of call */
- STDOBJREF std; /* data for returned interface */
+ HRESULT hResult; // result of call
+ STDOBJREF std; // data for returned interface
}
REMQIRESULT;
HRESULT RemQueryInterface (
- [in] IPID *ripid, /* interface to QI on */
- [in] uint32 cRefs, /* count of AddRefs requested */
- [in] uint16 cIids, /* count of IIDs that follow */
+ [in] IPID *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 */
+ IID* iids//, // IIDs to QI for
/*FIXME: [out, size_is(,cIids)]
- REMQIRESULT** ppQIResults /* results returned*/ */
+ REMQIRESULT** ppQIResults // results returned*/
);
typedef struct
{
- IPID ipid; /* ipid to AddRef/Release */
+ IPID ipid; // ipid to AddRef/Release
uint32 cPublicRefs;
uint32 cPrivateRefs;
} REMINTERFACEREF;
@@ -359,9 +359,9 @@ interface IRemUnknown : IUnknown
-/* Derived from IRemUnknown, this interface supports Remote Query interface */
-/* for objects that supply additional data beyond the STDOBJREF in their */
-/* marshaled interface packets. */
+// Derived from IRemUnknown, this interface supports Remote Query interface
+// for objects that supply additional data beyond the STDOBJREF in their
+// marshaled interface packets.
[
object,
uuid(00000143-0000-0000-C000-000000000046),
@@ -386,8 +386,8 @@ interface IRemUnknown2 : IRemUnknown
]
interface IOXIDResolver
{
- /* Method to get the protocol sequences, string bindings */
- /* and machine id for an object server given its OXID. */
+ // Method to get the protocol sequences, string bindings
+ // and machine id for an object server given its OXID.
typedef [public] struct {
DUALSTRINGARRAY *ppdsaOxidBindings;
@@ -402,40 +402,40 @@ interface IOXIDResolver
[out, ref] uint32 *pAuthnHint
);
- /* Simple ping is used to ping a Set. Client machines use this */
- /* to inform the object exporter that it is still using the */
- /* members of the set. */
- /* Returns S_TRUE if the SetId is known by the object exporter, */
- /* S_FALSE if not. */
+ // Simple ping is used to ping a Set. Client machines use this
+ // to inform the object exporter that it is still using the
+ // members of the set.
+ // Returns S_TRUE if the SetId is known by the object exporter,
+ // S_FALSE if not.
[idempotent] WERROR SimplePing (
- [in] SETID *pSetId /* Must not be zero */
+ [in] SETID *pSetId // Must not be zero
);
- /* Complex ping is used to create sets of OIDs to ping. The */
- /* whole set can subsequently be pinged using SimplePing, */
- /* thus reducing network traffic. */
+ // Complex ping is used to create sets of OIDs to ping. The
+ // whole set can subsequently be pinged using SimplePing,
+ // thus reducing network traffic.
[idempotent] WERROR ComplexPing (
- [in, out] SETID *pSetId, /* In of 0 on first call for new set. */
+ [in, out] SETID *pSetId, // In of 0 on first call for new set.
[in] uint16 SequenceNum,
[in] uint16 cAddToSet,
[in] uint16 cDelFromSet,
- /* add these OIDs to the set */
+ // add these OIDs to the set
[in, unique, size_is(cAddToSet)] OID AddToSet[],
- /*remove these OIDs from the set */
+ //remove these OIDs from the set
[in, unique, size_is(cDelFromSet)] OID DelFromSet[],
- [out] uint16 *pPingBackoffFactor/* 2^factor = multipler */
+ [out] uint16 *pPingBackoffFactor// 2^factor = multipler
);
- /* In some cases the client maybe unsure that a particular */
- /* binding will reach the server. (For example, when the oxid */
- /* bindings have more then one TCP/IP binding) This call */
- /* can be used to validate the binding */
- /* from the client. */
+ // In some cases the client maybe unsure that a particular
+ // binding will reach the server. (For example, when the oxid
+ // bindings have more then one TCP/IP binding) This call
+ // can be used to validate the binding
+ // from the client.
[idempotent] WERROR ServerAlive ();
- /* Method to get the protocol sequences, string bindings, */
- /* RemoteUnknown IPID and COM version for an object server */
- /* given its OXID. Supported by DCOM */
- /* version 5.2 and above. */
+ // Method to get the protocol sequences, string bindings,
+ // RemoteUnknown IPID and COM version for an object server
+ // given its OXID. Supported by DCOM
+ // version 5.2 and above.
[idempotent] WERROR ResolveOxid2 (
[in] OXID *pOxid,
[in] uint16 cRequestedProtseqs,
@@ -530,7 +530,7 @@ interface ISystemActivator : IUnknown
}
-/* Service Control Manager */
+// Service Control Manager
[
uuid(),