include/ndrtypes.h

   1 /*
   2  * NDR Types
   3  *
   4  * Copyright 2006 Robert Shearman (for CodeWeavers)
   5  *
   6  * This library is free software; you can redistribute it and/or
   7  * modify it under the terms of the GNU Lesser General Public
   8  * License as published by the Free Software Foundation; either
   9  * version 2.1 of the License, or (at your option) any later version.
  10  *
  11  * This library is distributed in the hope that it will be useful,
  12  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  13  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  14  * Lesser General Public License for more details.
  15  *
  16  * You should have received a copy of the GNU Lesser General Public
  17  * License along with this library; if not, write to the Free Software
  18  * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA
  19  */
  20
  21 #ifndef __NDRTYPES_H__
  22 #define __NDRTYPES_H__
  23
  24 typedef struct
  25 {
  26     unsigned short MustSize : 1; /* 0x0001 - client interpreter MUST size this
  27      *  parameter, other parameters may be skipped, using the value in
  28      *  NDR_PROC_PARTIAL_OIF_HEADER::constant_client_buffer_size instead. */
  29     unsigned short MustFree : 1; /* 0x0002 - server interpreter MUST size this
  30      *  parameter, other parameters may be skipped, using the value in
  31      *  NDR_PROC_PARTIAL_OIF_HEADER::constant_server_buffer_size instead. */
  32     unsigned short IsPipe : 1; /* 0x0004 - The parameter is a pipe handle. See
  33      *  http://msdn.microsoft.com/library/default.asp?url=/library/en-us/rpc/rpc/pipes.asp
  34      *  for more information on pipes. */
  35     unsigned short IsIn : 1; /* 0x0008 - The parameter is an input */
  36     unsigned short IsOut : 1; /* 0x0010 - The parameter is an output */
  37     unsigned short IsReturn : 1; /* 0x0020 - The parameter is to be returned */
  38     unsigned short IsBasetype : 1; /* 0x0040 - The parameter is simple and has the
  39      *  format defined by NDR_PARAM_OIF_BASETYPE rather than by
  40      *  NDR_PARAM_OIF_OTHER. */
  41     unsigned short IsByValue : 1; /* 0x0080 - Set for compound types being sent by
  42      *  value. Can be of type: structure, union, transmit_as, represent_as,
  43      *  wire_marshal and SAFEARRAY. */
  44     unsigned short IsSimpleRef : 1; /* 0x0100 - parameter that is a reference
  45      *  pointer to anything other than another pointer, and which has no
  46      *  allocate attributes. */
  47     unsigned short IsDontCallFreeInst : 1; /*  0x0200 - Used for some represent_as types
  48      *  for when the free instance routine should not be called. */
  49     unsigned short SaveForAsyncFinish : 1; /* 0x0400 - Unknown */
  50     unsigned short Unused : 2;
  51     unsigned short ServerAllocSize : 3; /* 0xe000 - If non-zero
  52      *  specifies the size of the object in numbers of 8byte blocks needed.
  53      *  It will be stored on the server's stack rather than using an allocate
  54      *  call. */
  55 } PARAM_ATTRIBUTES;
  56
  57 typedef struct
  58 {
  59     unsigned char ServerMustSize : 1; /* 0x01 - the server must perform a
  60      *  sizing pass. */
  61     unsigned char ClientMustSize : 1; /* 0x02 - the client must perform a
  62      *  sizing pass. */
  63     unsigned char HasReturn : 1; /* 0x04 - procedure has a return value. */
  64     unsigned char HasPipes : 1; /* 0x08 - the pipe package should be used. */
  65     unsigned char Unused : 1; /* 0x10 - not used */
  66     unsigned char HasAsyncUuid : 1; /* 0x20 - indicates an asynchronous DCOM
  67      *  procedure. */
  68     unsigned char HasExtensions : 1; /* 0x40 - indicates that Win2000
  69      *  extensions are in use. */
  70     unsigned char HasAsyncHandle : 1; /* 0x80 - indicates an asynchronous RPC
  71      *  procedure. */
  72 } INTERPRETER_OPT_FLAGS, *PINTERPRETER_OPT_FLAGS;
  73
  74 typedef struct
  75 {
  76     unsigned char HasNewCorrDesc : 1; /* 0x01 - indicates new correlation
  77      *  descriptors in use. */
  78     unsigned char ClientCorrCheck : 1; /* 0x02 - client needs correlation
  79      *  check. */
  80     unsigned char ServerCorrCheck : 1; /* 0x04 - server needs correlation
  81      *  check. */
  82     unsigned char HasNotify : 1; /* 0x08 - should call MIDL [notify]
  83      *  routine @ NotifyIndex. */
  84     unsigned char HasNotify2 : 1; /* 0x10 - should call MIDL [notify_flag] routine @
  85      *  NotifyIndex. */
  86     unsigned char Unused : 3;
  87 } INTERPRETER_OPT_FLAGS2, *PINTERPRETER_OPT_FLAGS2;
  88
  89 /* Win2000 extensions */
  90 typedef struct
  91 {
  92     /* size in bytes of all following extensions */
  93     unsigned char Size;
  94
  95     INTERPRETER_OPT_FLAGS2 Flags2;
  96
  97     /* client cache size hint */
  98     unsigned short ClientCorrHint;
  99
 100     /* server cache size hint */
 101     unsigned short ServerCorrHint;
 102
 103     /* index of routine in MIDL_STUB_DESC::NotifyRoutineTable to call if
 104      * HasNotify or HasNotify2 flag set */
 105     unsigned short NotifyIndex;
 106 } NDR_PROC_HEADER_EXTS;
 107
 108 typedef struct
 109 {
 110     /* size in bytes of all following extensions */
 111     unsigned char Size;
 112
 113     INTERPRETER_OPT_FLAGS2 Flags2;
 114
 115     /* client cache size hint */
 116     unsigned short ClientCorrHint;
 117
 118     /* server cache size hint */
 119     unsigned short ServerCorrHint;
 120
 121     /* index of routine in MIDL_STUB_DESC::NotifyRoutineTable to call if
 122      * HasNotify or HasNotify2 flag set */
 123     unsigned short NotifyIndex;
 124
 125     /* needed only on IA64 to cope with float/register loading */
 126     unsigned short FloatArgMask;
 127 } NDR_PROC_HEADER_EXTS64;
 128
 129 typedef enum
 130 {
 131     FC_BYTE = 0x01, /* 0x01 */
 132     FC_CHAR, /* 0x02 */
 133     FC_SMALL, /* 0x03 */
 134     FC_USMALL, /* 0x04 */
 135     FC_WCHAR, /* 0x05 */
 136     FC_SHORT, /* 0x06 */
 137     FC_USHORT, /* 0x07 */
 138     FC_LONG, /* 0x08 */
 139     FC_ULONG, /* 0x09 */
 140     FC_FLOAT, /* 0x0a */
 141     FC_HYPER, /* 0x0b */
 142     FC_DOUBLE, /* 0x0c */
 143     FC_ENUM16, /* 0x0d */
 144     FC_ENUM32, /* 0x0e */
 145     FC_IGNORE, /* 0x0f */
 146     FC_ERROR_STATUS_T, /* 0x10 */
 147
 148     FC_RP, /* 0x11 */ /* reference pointer */
 149     FC_UP, /* 0x12 */ /* unique pointer */
 150     FC_OP, /* 0x13 */ /* object pointer */
 151     FC_FP, /* 0x14 */ /* full pointer */
 152
 153     FC_STRUCT, /* 0x15 */ /* simple structure */
 154     FC_PSTRUCT, /* 0x16 */ /* simple structure w/ pointers */
 155     FC_CSTRUCT, /* 0x17 */ /* conformant structure */
 156     FC_CPSTRUCT, /* 0x18 */ /* conformant structure w/ pointers */
 157     FC_CVSTRUCT, /* 0x19 */ /* conformant varying struct */
 158     FC_BOGUS_STRUCT, /* 0x1a */ /* complex structure */
 159
 160     FC_CARRAY, /* 0x1b */ /* conformant array */
 161     FC_CVARRAY, /* 0x1c */ /* conformant varying array */
 162     FC_SMFARRAY, /* 0x1d */ /* small (<64K) fixed array */
 163     FC_LGFARRAY, /* 0x1e */ /* large (>= 64k) fixed array */
 164     FC_SMVARRAY, /* 0x1f */ /* small (<64k) varying array */
 165     FC_LGVARRAY, /* 0x20 */ /* large (>= 64k) varying array */
 166     FC_BOGUS_ARRAY, /* 0x21 */ /* complex array */
 167 } FORMAT_CHARACTER;
 168
 169 /* flags for all handle types */
 170 #define HANDLE_PARAM_IS_VIA_PTR 0x80
 171 #define HANDLE_PARAM_IS_IN      0x40
 172 #define HANDLE_PARAM_IS_OUT     0x20
 173 #define HANDLE_PARAM_IS_RETURN  0x10
 174
 175 /* flags for context handles */
 176 #define NDR_STRICT_CONTEXT_HANDLE           0x08
 177 #define NDR_CONTEXT_HANDLE_NOSERIALIZE      0x04
 178 #define NDR_CONTEXT_HANDLE_SERIALIZE        0x02
 179 #define NDR_CONTEXT_HANDLE_CANNOT_BE_NULL   0x01
 180
 181 #endif