shell32: Add stubbed SHGetKnownFolderPath.
[wine] / 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 #include <limits.h>
25
26 typedef struct
27 {
28     unsigned short MustSize : 1; /* 0x0001 - client interpreter MUST size this
29      *  parameter, other parameters may be skipped, using the value in
30      *  NDR_PROC_PARTIAL_OIF_HEADER::constant_client_buffer_size instead. */
31     unsigned short MustFree : 1; /* 0x0002 - server interpreter MUST size this
32      *  parameter, other parameters may be skipped, using the value in
33      *  NDR_PROC_PARTIAL_OIF_HEADER::constant_server_buffer_size instead. */
34     unsigned short IsPipe : 1; /* 0x0004 - The parameter is a pipe handle */
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