2 * Object management functions
4 * Copyright 1999, 2000 Juergen Schmied
5 * Copyright 2005 Vitaliy Margolen
7 * This library is free software; you can redistribute it and/or
8 * modify it under the terms of the GNU Lesser General Public
9 * License as published by the Free Software Foundation; either
10 * version 2.1 of the License, or (at your option) any later version.
12 * This library is distributed in the hope that it will be useful,
13 * but WITHOUT ANY WARRANTY; without even the implied warranty of
14 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
15 * Lesser General Public License for more details.
17 * You should have received a copy of the GNU Lesser General Public
18 * License along with this library; if not, write to the Free Software
19 * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA
35 #define WIN32_NO_STATUS
36 #include "wine/debug.h"
39 #include "ntdll_misc.h"
40 #include "wine/server.h"
42 WINE_DEFAULT_DEBUG_CHANNEL(ntdll);
46 * Generic object functions
49 /******************************************************************************
50 * NtQueryObject [NTDLL.@]
51 * ZwQueryObject [NTDLL.@]
53 NTSTATUS WINAPI NtQueryObject(IN HANDLE handle,
54 IN OBJECT_INFORMATION_CLASS info_class,
55 OUT PVOID ptr, IN ULONG len, OUT PULONG used_len)
59 TRACE("(%p,0x%08x,%p,0x%08x,%p): stub\n",
60 handle, info_class, ptr, len, used_len);
62 if (used_len) *used_len = 0;
66 case ObjectBasicInformation:
68 POBJECT_BASIC_INFORMATION p = (POBJECT_BASIC_INFORMATION)ptr;
70 if (len < sizeof(*p)) return STATUS_INVALID_BUFFER_SIZE;
72 SERVER_START_REQ( get_object_info )
75 status = wine_server_call( req );
76 if (status == STATUS_SUCCESS)
78 memset( p, 0, sizeof(*p) );
79 p->GrantedAccess = reply->access;
80 p->PointerCount = reply->ref_count;
81 p->HandleCount = 1; /* at least one */
82 if (used_len) *used_len = sizeof(*p);
88 case ObjectDataInformation:
90 OBJECT_DATA_INFORMATION* p = (OBJECT_DATA_INFORMATION*)ptr;
92 if (len < sizeof(*p)) return STATUS_INVALID_BUFFER_SIZE;
94 SERVER_START_REQ( set_handle_info )
99 status = wine_server_call( req );
100 if (status == STATUS_SUCCESS)
102 p->InheritHandle = (reply->old_flags & HANDLE_FLAG_INHERIT) ? TRUE : FALSE;
103 p->ProtectFromClose = (reply->old_flags & HANDLE_FLAG_PROTECT_FROM_CLOSE) ? TRUE : FALSE;
104 if (used_len) *used_len = sizeof(*p);
111 FIXME("Unsupported information class %u\n", info_class);
112 status = STATUS_NOT_IMPLEMENTED;
118 /******************************************************************
119 * NtSetInformationObject [NTDLL.@]
120 * ZwSetInformationObject [NTDLL.@]
123 NTSTATUS WINAPI NtSetInformationObject(IN HANDLE handle,
124 IN OBJECT_INFORMATION_CLASS info_class,
125 IN PVOID ptr, IN ULONG len)
129 TRACE("(%p,0x%08x,%p,0x%08x): stub\n",
130 handle, info_class, ptr, len);
134 case ObjectDataInformation:
136 OBJECT_DATA_INFORMATION* p = (OBJECT_DATA_INFORMATION*)ptr;
138 if (len < sizeof(*p)) return STATUS_INVALID_BUFFER_SIZE;
140 SERVER_START_REQ( set_handle_info )
142 req->handle = handle;
144 req->mask = HANDLE_FLAG_INHERIT | HANDLE_FLAG_PROTECT_FROM_CLOSE;
145 if (p->InheritHandle) req->flags |= HANDLE_FLAG_INHERIT;
146 if (p->ProtectFromClose) req->flags |= HANDLE_FLAG_PROTECT_FROM_CLOSE;
147 status = wine_server_call( req );
153 FIXME("Unsupported information class %u\n", info_class);
154 status = STATUS_NOT_IMPLEMENTED;
160 /******************************************************************************
161 * NtQuerySecurityObject [NTDLL.@]
163 * An ntdll analogue to GetKernelObjectSecurity().
167 NtQuerySecurityObject(
169 IN SECURITY_INFORMATION RequestedInformation,
170 OUT PSECURITY_DESCRIPTOR pSecurityDescriptor,
172 OUT PULONG ResultLength)
174 PISECURITY_DESCRIPTOR_RELATIVE psd = pSecurityDescriptor;
176 unsigned int buffer_size = 512;
177 BOOLEAN need_more_memory = FALSE;
179 TRACE("(%p,0x%08x,%p,0x%08x,%p)\n",
180 Object, RequestedInformation, pSecurityDescriptor, Length, ResultLength);
184 char *buffer = RtlAllocateHeap(GetProcessHeap(), 0, buffer_size);
186 return STATUS_NO_MEMORY;
188 SERVER_START_REQ( get_security_object )
190 req->handle = Object;
191 req->security_info = RequestedInformation;
192 wine_server_set_reply( req, buffer, buffer_size );
193 status = wine_server_call( req );
194 if (status == STATUS_SUCCESS)
196 struct security_descriptor *sd = (struct security_descriptor *)buffer;
199 *ResultLength = sizeof(SECURITY_DESCRIPTOR_RELATIVE) +
200 sd->owner_len + sd->group_len + sd->sacl_len + sd->dacl_len;
201 if (Length >= *ResultLength)
203 psd->Revision = SECURITY_DESCRIPTOR_REVISION;
205 psd->Control = sd->control | SE_SELF_RELATIVE;
206 psd->Owner = sd->owner_len ? sizeof(SECURITY_DESCRIPTOR_RELATIVE) : 0;
207 psd->Group = sd->group_len ? sizeof(SECURITY_DESCRIPTOR_RELATIVE) + sd->owner_len : 0;
208 psd->Sacl = sd->sacl_len ? sizeof(SECURITY_DESCRIPTOR_RELATIVE) + sd->owner_len + sd->group_len : 0;
209 psd->Dacl = sd->dacl_len ? sizeof(SECURITY_DESCRIPTOR_RELATIVE) + sd->owner_len + sd->group_len + sd->sacl_len : 0;
210 /* owner, group, sacl and dacl are the same type as in the server
211 * and in the same order so we copy the memory in one block */
212 memcpy((char *)pSecurityDescriptor + sizeof(SECURITY_DESCRIPTOR_RELATIVE),
213 buffer + sizeof(struct security_descriptor),
214 sd->owner_len + sd->group_len + sd->sacl_len + sd->dacl_len);
217 status = STATUS_BUFFER_TOO_SMALL;
221 *ResultLength = sizeof(SECURITY_DESCRIPTOR_RELATIVE);
222 if (Length >= *ResultLength)
224 memset(psd, 0, sizeof(*psd));
225 psd->Revision = SECURITY_DESCRIPTOR_REVISION;
226 psd->Control = SE_SELF_RELATIVE;
229 status = STATUS_BUFFER_TOO_SMALL;
232 else if (status == STATUS_BUFFER_TOO_SMALL)
234 buffer_size = reply->sd_len;
235 need_more_memory = TRUE;
239 RtlFreeHeap(GetProcessHeap(), 0, buffer);
240 } while (need_more_memory);
246 /******************************************************************************
247 * NtDuplicateObject [NTDLL.@]
248 * ZwDuplicateObject [NTDLL.@]
250 NTSTATUS WINAPI NtDuplicateObject( HANDLE source_process, HANDLE source,
251 HANDLE dest_process, PHANDLE dest,
252 ACCESS_MASK access, ULONG attributes, ULONG options )
255 SERVER_START_REQ( dup_handle )
257 req->src_process = source_process;
258 req->src_handle = source;
259 req->dst_process = dest_process;
260 req->access = access;
261 req->attributes = attributes;
262 req->options = options;
264 if (!(ret = wine_server_call( req )))
266 if (dest) *dest = reply->handle;
271 int fd = server_remove_fd_from_cache( source );
272 if (fd != -1) close( fd );
275 else if (options & DUPLICATE_CLOSE_SOURCE)
276 WARN( "failed to close handle %p in process %p\n", source, source_process );
283 /**************************************************************************
286 * Close a handle reference to an object.
289 * Handle [I] handle to close
292 * Success: ERROR_SUCCESS.
293 * Failure: An NTSTATUS error code.
295 NTSTATUS WINAPI NtClose( HANDLE Handle )
298 int fd = server_remove_fd_from_cache( Handle );
300 SERVER_START_REQ( close_handle )
302 req->handle = Handle;
303 ret = wine_server_call( req );
306 if (fd != -1) close( fd );
311 * Directory functions
314 /**************************************************************************
315 * NtOpenDirectoryObject [NTDLL.@]
316 * ZwOpenDirectoryObject [NTDLL.@]
318 * Open a namespace directory object.
321 * DirectoryHandle [O] Destination for the new directory handle
322 * DesiredAccess [I] Desired access to the directory
323 * ObjectAttributes [I] Structure describing the directory
326 * Success: ERROR_SUCCESS.
327 * Failure: An NTSTATUS error code.
329 NTSTATUS WINAPI NtOpenDirectoryObject(PHANDLE DirectoryHandle, ACCESS_MASK DesiredAccess,
330 POBJECT_ATTRIBUTES ObjectAttributes)
333 TRACE("(%p,0x%08x)\n", DirectoryHandle, DesiredAccess);
334 dump_ObjectAttributes(ObjectAttributes);
336 if (!DirectoryHandle) return STATUS_ACCESS_VIOLATION;
337 if (!ObjectAttributes) return STATUS_INVALID_PARAMETER;
338 /* Have to test it here because server won't know difference between
339 * ObjectName == NULL and ObjectName == "" */
340 if (!ObjectAttributes->ObjectName)
342 if (ObjectAttributes->RootDirectory)
343 return STATUS_OBJECT_NAME_INVALID;
345 return STATUS_OBJECT_PATH_SYNTAX_BAD;
348 SERVER_START_REQ(open_directory)
350 req->access = DesiredAccess;
351 req->attributes = ObjectAttributes->Attributes;
352 req->rootdir = ObjectAttributes->RootDirectory;
353 if (ObjectAttributes->ObjectName)
354 wine_server_add_data(req, ObjectAttributes->ObjectName->Buffer,
355 ObjectAttributes->ObjectName->Length);
356 ret = wine_server_call( req );
357 *DirectoryHandle = reply->handle;
363 /******************************************************************************
364 * NtCreateDirectoryObject [NTDLL.@]
365 * ZwCreateDirectoryObject [NTDLL.@]
367 * Create a namespace directory object.
370 * DirectoryHandle [O] Destination for the new directory handle
371 * DesiredAccess [I] Desired access to the directory
372 * ObjectAttributes [I] Structure describing the directory
375 * Success: ERROR_SUCCESS.
376 * Failure: An NTSTATUS error code.
378 NTSTATUS WINAPI NtCreateDirectoryObject(PHANDLE DirectoryHandle, ACCESS_MASK DesiredAccess,
379 POBJECT_ATTRIBUTES ObjectAttributes)
382 TRACE("(%p,0x%08x)\n", DirectoryHandle, DesiredAccess);
383 dump_ObjectAttributes(ObjectAttributes);
385 if (!DirectoryHandle) return STATUS_ACCESS_VIOLATION;
387 SERVER_START_REQ(create_directory)
389 req->access = DesiredAccess;
390 req->attributes = ObjectAttributes ? ObjectAttributes->Attributes : 0;
391 req->rootdir = ObjectAttributes ? ObjectAttributes->RootDirectory : 0;
392 if (ObjectAttributes && ObjectAttributes->ObjectName)
393 wine_server_add_data(req, ObjectAttributes->ObjectName->Buffer,
394 ObjectAttributes->ObjectName->Length);
395 ret = wine_server_call( req );
396 *DirectoryHandle = reply->handle;
402 /******************************************************************************
403 * NtQueryDirectoryObject [NTDLL.@]
404 * ZwQueryDirectoryObject [NTDLL.@]
406 * Read information from a namespace directory.
409 * handle [I] Handle to a directory object
410 * buffer [O] Buffer to hold the read data
411 * size [I] Size of the buffer in bytes
412 * single_entry [I] If TRUE, return a single entry, if FALSE, return as many as fit in the buffer
413 * restart [I] If TRUE, start scanning from the start, if FALSE, scan from Context
414 * context [I/O] Indicates what point of the directory the scan is at
415 * ret_size [O] Caller supplied storage for the number of bytes written (or NULL)
418 * Success: ERROR_SUCCESS.
419 * Failure: An NTSTATUS error code.
421 NTSTATUS WINAPI NtQueryDirectoryObject(HANDLE handle, PDIRECTORY_BASIC_INFORMATION buffer,
422 ULONG size, BOOLEAN single_entry, BOOLEAN restart,
423 PULONG context, PULONG ret_size)
427 if (restart) *context = 0;
431 if (size <= sizeof(*buffer) + 2*sizeof(WCHAR)) return STATUS_BUFFER_OVERFLOW;
433 SERVER_START_REQ( get_directory_entry )
435 req->handle = handle;
436 req->index = *context;
437 wine_server_set_reply( req, buffer + 1, size - sizeof(*buffer) - 2*sizeof(WCHAR) );
438 if (!(ret = wine_server_call( req )))
440 buffer->ObjectName.Buffer = (WCHAR *)(buffer + 1);
441 buffer->ObjectName.Length = reply->name_len;
442 buffer->ObjectName.MaximumLength = reply->name_len + sizeof(WCHAR);
443 buffer->ObjectTypeName.Buffer = (WCHAR *)(buffer + 1) + reply->name_len/sizeof(WCHAR) + 1;
444 buffer->ObjectTypeName.Length = wine_server_reply_size( reply ) - reply->name_len;
445 buffer->ObjectTypeName.MaximumLength = buffer->ObjectTypeName.Length + sizeof(WCHAR);
446 /* make room for the terminating null */
447 memmove( buffer->ObjectTypeName.Buffer, buffer->ObjectTypeName.Buffer - 1,
448 buffer->ObjectTypeName.Length );
449 buffer->ObjectName.Buffer[buffer->ObjectName.Length/sizeof(WCHAR)] = 0;
450 buffer->ObjectTypeName.Buffer[buffer->ObjectTypeName.Length/sizeof(WCHAR)] = 0;
456 *ret_size = buffer->ObjectName.MaximumLength + buffer->ObjectTypeName.MaximumLength + sizeof(*buffer);
460 FIXME("multiple entries not implemented\n");
461 ret = STATUS_NOT_IMPLEMENTED;
471 /******************************************************************************
472 * NtOpenSymbolicLinkObject [NTDLL.@]
473 * ZwOpenSymbolicLinkObject [NTDLL.@]
475 * Open a namespace symbolic link object.
478 * LinkHandle [O] Destination for the new symbolic link handle
479 * DesiredAccess [I] Desired access to the symbolic link
480 * ObjectAttributes [I] Structure describing the symbolic link
483 * Success: ERROR_SUCCESS.
484 * Failure: An NTSTATUS error code.
486 NTSTATUS WINAPI NtOpenSymbolicLinkObject(OUT PHANDLE LinkHandle, IN ACCESS_MASK DesiredAccess,
487 IN POBJECT_ATTRIBUTES ObjectAttributes)
490 TRACE("(%p,0x%08x,%p)\n",LinkHandle, DesiredAccess, ObjectAttributes);
491 dump_ObjectAttributes(ObjectAttributes);
493 if (!LinkHandle) return STATUS_ACCESS_VIOLATION;
494 if (!ObjectAttributes) return STATUS_INVALID_PARAMETER;
495 /* Have to test it here because server won't know difference between
496 * ObjectName == NULL and ObjectName == "" */
497 if (!ObjectAttributes->ObjectName)
499 if (ObjectAttributes->RootDirectory)
500 return STATUS_OBJECT_NAME_INVALID;
502 return STATUS_OBJECT_PATH_SYNTAX_BAD;
505 SERVER_START_REQ(open_symlink)
507 req->access = DesiredAccess;
508 req->attributes = ObjectAttributes->Attributes;
509 req->rootdir = ObjectAttributes->RootDirectory;
510 if (ObjectAttributes->ObjectName)
511 wine_server_add_data(req, ObjectAttributes->ObjectName->Buffer,
512 ObjectAttributes->ObjectName->Length);
513 ret = wine_server_call( req );
514 *LinkHandle = reply->handle;
520 /******************************************************************************
521 * NtCreateSymbolicLinkObject [NTDLL.@]
522 * ZwCreateSymbolicLinkObject [NTDLL.@]
524 * Open a namespace symbolic link object.
527 * SymbolicLinkHandle [O] Destination for the new symbolic link handle
528 * DesiredAccess [I] Desired access to the symbolic link
529 * ObjectAttributes [I] Structure describing the symbolic link
530 * TargetName [I] Name of the target symbolic link points to
533 * Success: ERROR_SUCCESS.
534 * Failure: An NTSTATUS error code.
536 NTSTATUS WINAPI NtCreateSymbolicLinkObject(OUT PHANDLE SymbolicLinkHandle,IN ACCESS_MASK DesiredAccess,
537 IN POBJECT_ATTRIBUTES ObjectAttributes,
538 IN PUNICODE_STRING TargetName)
541 TRACE("(%p,0x%08x,%p, -> %s)\n", SymbolicLinkHandle, DesiredAccess, ObjectAttributes,
542 debugstr_us(TargetName));
543 dump_ObjectAttributes(ObjectAttributes);
545 if (!SymbolicLinkHandle || !TargetName) return STATUS_ACCESS_VIOLATION;
546 if (!TargetName->Buffer) return STATUS_INVALID_PARAMETER;
548 SERVER_START_REQ(create_symlink)
550 req->access = DesiredAccess;
551 req->attributes = ObjectAttributes ? ObjectAttributes->Attributes : 0;
552 req->rootdir = ObjectAttributes ? ObjectAttributes->RootDirectory : 0;
553 if (ObjectAttributes && ObjectAttributes->ObjectName)
555 req->name_len = ObjectAttributes->ObjectName->Length;
556 wine_server_add_data(req, ObjectAttributes->ObjectName->Buffer,
557 ObjectAttributes->ObjectName->Length);
561 wine_server_add_data(req, TargetName->Buffer, TargetName->Length);
562 ret = wine_server_call( req );
563 *SymbolicLinkHandle = reply->handle;
569 /******************************************************************************
570 * NtQuerySymbolicLinkObject [NTDLL.@]
571 * ZwQuerySymbolicLinkObject [NTDLL.@]
573 * Query a namespace symbolic link object target name.
576 * LinkHandle [I] Handle to a symbolic link object
577 * LinkTarget [O] Destination for the symbolic link target
578 * ReturnedLength [O] Size of returned data
581 * Success: ERROR_SUCCESS.
582 * Failure: An NTSTATUS error code.
584 NTSTATUS WINAPI NtQuerySymbolicLinkObject(IN HANDLE LinkHandle, IN OUT PUNICODE_STRING LinkTarget,
585 OUT PULONG ReturnedLength OPTIONAL)
588 TRACE("(%p,%p,%p)\n", LinkHandle, LinkTarget, ReturnedLength);
590 if (!LinkTarget) return STATUS_ACCESS_VIOLATION;
592 SERVER_START_REQ(query_symlink)
594 req->handle = LinkHandle;
595 wine_server_set_reply( req, LinkTarget->Buffer, LinkTarget->MaximumLength );
596 if (!(ret = wine_server_call( req )))
598 LinkTarget->Length = wine_server_reply_size(reply);
599 if (ReturnedLength) *ReturnedLength = LinkTarget->Length;
606 /******************************************************************************
607 * NtAllocateUuids [NTDLL.@]
609 NTSTATUS WINAPI NtAllocateUuids(
610 PULARGE_INTEGER Time,
614 FIXME("(%p,%p,%p), stub.\n", Time, Range, Sequence);