2 winreg interface definition
5 import "lsa.idl", "security.idl";
8 uuid("338cd001-2244-31f1-aaaa-900038001003"),
10 endpoint("ncacn_np:[\\pipe\\winreg]","ncacn_ip_tcp:","ncalrpc:"),
11 pointer_default(unique),
12 helpstring("Remote Registry Service")
15 typedef bitmap security_secinfo security_secinfo;
17 typedef [bitmap32bit] bitmap {
18 KEY_QUERY_VALUE = 0x00001,
19 KEY_SET_VALUE = 0x00002,
20 KEY_CREATE_SUB_KEY = 0x00004,
21 KEY_ENUMERATE_SUB_KEYS = 0x00008,
23 KEY_CREATE_LINK = 0x00020,
24 KEY_WOW64_64KEY = 0x00100,
25 KEY_WOW64_32KEY = 0x00200
28 typedef [public,v1_enum] enum {
34 REG_DWORD_BIG_ENDIAN = 5,
37 REG_RESOURCE_LIST = 8,
38 REG_FULL_RESOURCE_DESCRIPTOR = 9,
39 REG_RESOURCE_REQUIREMENTS_LIST = 10,
43 typedef [public,noejs] struct {
44 [value(strlen_m_term(name)*2)] uint16 name_len;
45 [value(strlen_m_term(name)*2)] uint16 name_size;
46 [string,charset(UTF16)] uint16 *name;
51 WERROR winreg_OpenHKCR(
52 [in,unique] uint16 *system_name,
53 [in] winreg_AccessMask access_mask,
54 [out,ref] policy_handle *handle
59 WERROR winreg_OpenHKCU(
60 [in,unique] uint16 *system_name,
61 [in] winreg_AccessMask access_mask,
62 [out,ref] policy_handle *handle
67 [public] WERROR winreg_OpenHKLM(
68 [in,unique] uint16 *system_name,
69 [in] winreg_AccessMask access_mask,
70 [out,ref] policy_handle *handle
75 WERROR winreg_OpenHKPD(
76 [in,unique] uint16 *system_name,
77 [in] winreg_AccessMask access_mask,
78 [out,ref] policy_handle *handle
83 WERROR winreg_OpenHKU(
84 [in,unique] uint16 *system_name,
85 [in] winreg_AccessMask access_mask,
86 [out,ref] policy_handle *handle
91 [public] WERROR winreg_CloseKey(
92 [in,out,ref] policy_handle *handle
99 [size_is(size),length_is(len)] uint8 *data;
110 typedef [v1_enum] enum {
111 REG_ACTION_NONE = 0, /* used by caller */
112 REG_CREATED_NEW_KEY = 1,
113 REG_OPENED_EXISTING_KEY = 2
114 } winreg_CreateAction;
116 [public] WERROR winreg_CreateKey(
117 [in,ref] policy_handle *handle,
118 [in] winreg_String name,
119 [in] winreg_String keyclass,
121 [in] winreg_AccessMask access_mask,
122 [in,unique] winreg_SecBuf *secdesc,
123 [out,ref] policy_handle *new_handle,
124 [in,out,unique] winreg_CreateAction *action_taken
129 [public] WERROR winreg_DeleteKey(
130 [in,ref] policy_handle *handle,
131 [in] winreg_String key
136 WERROR winreg_DeleteValue(
137 [in,ref] policy_handle *handle,
138 [in] winreg_String value
142 [value(strlen_m_term_null(name)*2)] uint16 length;
143 /* size cannot be auto-set by value() as it is the
144 amount of space the server is allowed to use for this
145 string in the reply, not its current size */
147 [size_is(size/2),length_is(length/2),charset(UTF16)] uint16 *name;
152 [public] WERROR winreg_EnumKey(
153 [in,ref] policy_handle *handle,
154 [in] uint32 enum_index,
155 [in,out,ref] winreg_StringBuf *name,
156 [in,out,unique] winreg_StringBuf *keyclass,
157 [in,out,unique] NTTIME *last_changed_time
161 [value(strlen_m_term(name)*2)] uint16 length;
162 /* size cannot be auto-set by value() as it is the
163 amount of space the server is allowed to use for this
164 string in the reply, not its current size */
166 [size_is(size/2),length_is(length/2),charset(UTF16)] uint16 *name;
172 [public] WERROR winreg_EnumValue(
173 [in,ref] policy_handle *handle,
174 [in] uint32 enum_index,
175 [in,out,ref] winreg_ValNameBuf *name,
176 [in,out,unique] winreg_Type *type,
177 [in,out,unique,size_is(*size),length_is(*length)] uint8 *value,
178 [in,out,unique] uint32 *size,
179 [in,out,unique] uint32 *length
184 [public] WERROR winreg_FlushKey(
185 [in,ref] policy_handle *handle
190 [public] WERROR winreg_GetKeySecurity(
191 [in,ref] policy_handle *handle,
192 [in] security_secinfo sec_info,
193 [in,out,ref] KeySecurityData *sd
198 WERROR winreg_LoadKey(
199 [in,ref] policy_handle *handle,
200 [in,unique] winreg_String *keyname,
201 [in,unique] winreg_String *filename
206 typedef [public,bitmap32bit] bitmap {
207 REG_NOTIFY_CHANGE_NAME = 0x00000001,
208 REG_NOTIFY_CHANGE_ATTRIBUTES = 0x00000002,
209 REG_NOTIFY_CHANGE_LAST_SET = 0x00000004,
210 REG_NOTIFY_CHANGE_SECURITY = 0x00000008
211 } winreg_NotifyChangeType;
213 [public] WERROR winreg_NotifyChangeKeyValue(
214 [in,ref] policy_handle *handle,
215 [in] boolean8 watch_subtree,
216 [in] winreg_NotifyChangeType notify_filter,
218 [in] winreg_String string1,
219 [in] winreg_String string2,
225 [public] WERROR winreg_OpenKey(
226 [in,ref] policy_handle *parent_handle,
227 [in] winreg_String keyname,
229 [in] winreg_AccessMask access_mask,
230 [out,ref] policy_handle *handle
235 [public] WERROR winreg_QueryInfoKey(
236 [in,ref] policy_handle *handle,
237 [in,out,ref] winreg_String *classname,
238 [out,ref] uint32 *num_subkeys,
239 [out,ref] uint32 *max_subkeylen,
240 [out,ref] uint32 *max_classlen,
241 [out,ref] uint32 *num_values,
242 [out,ref] uint32 *max_valnamelen,
243 [out,ref] uint32 *max_valbufsize,
244 [out,ref] uint32 *secdescsize,
245 [out,ref] NTTIME *last_changed_time
250 [public] WERROR winreg_QueryValue(
251 [in,ref] policy_handle *handle,
252 [in,ref] winreg_String *value_name,
253 [in,out,unique] winreg_Type *type,
254 [in,out,unique,size_is(*data_size),length_is(*data_length)] uint8 *data,
255 [in,out,unique] uint32 *data_size,
256 [in,out,unique] uint32 *data_length
261 [todo] WERROR winreg_ReplaceKey(
266 WERROR winreg_RestoreKey(
267 [in,ref] policy_handle *handle,
268 [in,ref] winreg_String *filename,
277 KeySecurityData sec_data;
279 } KeySecurityAttribute;
281 WERROR winreg_SaveKey(
282 [in,ref] policy_handle *handle,
283 [in,ref] winreg_String *filename,
284 [in,unique] KeySecurityAttribute *sec_attrib
289 WERROR winreg_SetKeySecurity(
290 [in,ref] policy_handle *handle,
291 [in] security_secinfo sec_info,
292 [in,ref] KeySecurityData *sd
297 WERROR winreg_SetValue(
298 [in,ref] policy_handle *handle,
299 [in] winreg_String name,
300 [in] winreg_Type type,
301 [in,size_is(size),ref] uint8 *data,
307 [todo] WERROR winreg_UnLoadKey(
312 WERROR winreg_InitiateSystemShutdown(
313 [in,unique] uint16 *hostname,
315 * Note: lsa_String and winreg_String both result
316 * in WERR_INVALID_PARAM
318 [in,unique] lsa_StringLarge *message,
320 [in] uint8 force_apps,
326 WERROR winreg_AbortSystemShutdown(
327 [in,unique] uint16 *server
332 [public] WERROR winreg_GetVersion(
333 [in,ref] policy_handle *handle,
334 [out,ref] uint32 *version
339 WERROR winreg_OpenHKCC(
340 [in,unique] uint16 *system_name,
341 [in] winreg_AccessMask access_mask,
342 [out,ref] policy_handle *handle
347 WERROR winreg_OpenHKDD(
348 [in,unique] uint16 *system_name,
349 [in] winreg_AccessMask access_mask,
350 [out,ref] policy_handle *handle
358 } QueryMultipleValue;
362 [public] WERROR winreg_QueryMultipleValues(
363 [in,ref] policy_handle *key_handle,
364 [in,out,ref,size_is(num_values),length_is(num_values)] QueryMultipleValue *values,
365 [in] uint32 num_values,
366 [in,out,unique,size_is(*buffer_size),length_is(*buffer_size)] uint8 *buffer,
367 [in,out,ref] uint32 *buffer_size
372 WERROR winreg_InitiateSystemShutdownEx(
373 [in,unique] uint16 *hostname,
375 * Note: lsa_String and winreg_String both result
376 * in WERR_INVALID_PARAM
378 [in,unique] lsa_StringLarge *message,
380 [in] uint8 force_apps,
381 [in] uint8 do_reboot,
387 [todo] WERROR winreg_SaveKeyEx(
392 WERROR winreg_OpenHKPT(
393 [in,unique] uint16 *system_name,
394 [in] winreg_AccessMask access_mask,
395 [out,ref] policy_handle *handle
400 WERROR winreg_OpenHKPN(
401 [in,unique] uint16 *system_name,
402 [in] winreg_AccessMask access_mask,
403 [out,ref] policy_handle *handle
408 [todo] WERROR winreg_QueryMultipleValues2(