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
)
74 req
->handle
= wine_server_obj_handle( handle
);
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
)
96 req
->handle
= wine_server_obj_handle( handle
);
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
= wine_server_obj_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
;
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 need_more_memory
= FALSE
;
190 SERVER_START_REQ( get_security_object
)
192 req
->handle
= wine_server_obj_handle( Object
);
193 req
->security_info
= RequestedInformation
;
194 wine_server_set_reply( req
, buffer
, buffer_size
);
195 status
= wine_server_call( req
);
196 if (status
== STATUS_SUCCESS
)
198 struct security_descriptor
*sd
= (struct security_descriptor
*)buffer
;
201 *ResultLength
= sizeof(SECURITY_DESCRIPTOR_RELATIVE
) +
202 sd
->owner_len
+ sd
->group_len
+ sd
->sacl_len
+ sd
->dacl_len
;
203 if (Length
>= *ResultLength
)
205 psd
->Revision
= SECURITY_DESCRIPTOR_REVISION
;
207 psd
->Control
= sd
->control
| SE_SELF_RELATIVE
;
208 psd
->Owner
= sd
->owner_len
? sizeof(SECURITY_DESCRIPTOR_RELATIVE
) : 0;
209 psd
->Group
= sd
->group_len
? sizeof(SECURITY_DESCRIPTOR_RELATIVE
) + sd
->owner_len
: 0;
210 psd
->Sacl
= sd
->sacl_len
? sizeof(SECURITY_DESCRIPTOR_RELATIVE
) + sd
->owner_len
+ sd
->group_len
: 0;
211 psd
->Dacl
= sd
->dacl_len
? sizeof(SECURITY_DESCRIPTOR_RELATIVE
) + sd
->owner_len
+ sd
->group_len
+ sd
->sacl_len
: 0;
212 /* owner, group, sacl and dacl are the same type as in the server
213 * and in the same order so we copy the memory in one block */
214 memcpy((char *)pSecurityDescriptor
+ sizeof(SECURITY_DESCRIPTOR_RELATIVE
),
215 buffer
+ sizeof(struct security_descriptor
),
216 sd
->owner_len
+ sd
->group_len
+ sd
->sacl_len
+ sd
->dacl_len
);
219 status
= STATUS_BUFFER_TOO_SMALL
;
223 *ResultLength
= sizeof(SECURITY_DESCRIPTOR_RELATIVE
);
224 if (Length
>= *ResultLength
)
226 memset(psd
, 0, sizeof(*psd
));
227 psd
->Revision
= SECURITY_DESCRIPTOR_REVISION
;
228 psd
->Control
= SE_SELF_RELATIVE
;
231 status
= STATUS_BUFFER_TOO_SMALL
;
234 else if (status
== STATUS_BUFFER_TOO_SMALL
)
236 buffer_size
= reply
->sd_len
;
237 need_more_memory
= TRUE
;
241 RtlFreeHeap(GetProcessHeap(), 0, buffer
);
242 } while (need_more_memory
);
248 /******************************************************************************
249 * NtDuplicateObject [NTDLL.@]
250 * ZwDuplicateObject [NTDLL.@]
252 NTSTATUS WINAPI
NtDuplicateObject( HANDLE source_process
, HANDLE source
,
253 HANDLE dest_process
, PHANDLE dest
,
254 ACCESS_MASK access
, ULONG attributes
, ULONG options
)
257 SERVER_START_REQ( dup_handle
)
259 req
->src_process
= wine_server_obj_handle( source_process
);
260 req
->src_handle
= wine_server_obj_handle( source
);
261 req
->dst_process
= wine_server_obj_handle( dest_process
);
262 req
->access
= access
;
263 req
->attributes
= attributes
;
264 req
->options
= options
;
266 if (!(ret
= wine_server_call( req
)))
268 if (dest
) *dest
= wine_server_ptr_handle( reply
->handle
);
273 int fd
= server_remove_fd_from_cache( source
);
274 if (fd
!= -1) close( fd
);
277 else if (options
& DUPLICATE_CLOSE_SOURCE
)
278 WARN( "failed to close handle %p in process %p\n", source
, source_process
);
285 /**************************************************************************
288 * Close a handle reference to an object.
291 * Handle [I] handle to close
294 * Success: ERROR_SUCCESS.
295 * Failure: An NTSTATUS error code.
297 NTSTATUS WINAPI
NtClose( HANDLE Handle
)
300 int fd
= server_remove_fd_from_cache( Handle
);
302 SERVER_START_REQ( close_handle
)
304 req
->handle
= wine_server_obj_handle( Handle
);
305 ret
= wine_server_call( req
);
308 if (fd
!= -1) close( fd
);
313 * Directory functions
316 /**************************************************************************
317 * NtOpenDirectoryObject [NTDLL.@]
318 * ZwOpenDirectoryObject [NTDLL.@]
320 * Open a namespace directory object.
323 * DirectoryHandle [O] Destination for the new directory handle
324 * DesiredAccess [I] Desired access to the directory
325 * ObjectAttributes [I] Structure describing the directory
328 * Success: ERROR_SUCCESS.
329 * Failure: An NTSTATUS error code.
331 NTSTATUS WINAPI
NtOpenDirectoryObject(PHANDLE DirectoryHandle
, ACCESS_MASK DesiredAccess
,
332 POBJECT_ATTRIBUTES ObjectAttributes
)
335 TRACE("(%p,0x%08x,%s)\n", DirectoryHandle
, DesiredAccess
, debugstr_ObjectAttributes(ObjectAttributes
));
337 if (!DirectoryHandle
) return STATUS_ACCESS_VIOLATION
;
338 if (!ObjectAttributes
) return STATUS_INVALID_PARAMETER
;
339 /* Have to test it here because server won't know difference between
340 * ObjectName == NULL and ObjectName == "" */
341 if (!ObjectAttributes
->ObjectName
)
343 if (ObjectAttributes
->RootDirectory
)
344 return STATUS_OBJECT_NAME_INVALID
;
346 return STATUS_OBJECT_PATH_SYNTAX_BAD
;
349 SERVER_START_REQ(open_directory
)
351 req
->access
= DesiredAccess
;
352 req
->attributes
= ObjectAttributes
->Attributes
;
353 req
->rootdir
= wine_server_obj_handle( ObjectAttributes
->RootDirectory
);
354 if (ObjectAttributes
->ObjectName
)
355 wine_server_add_data(req
, ObjectAttributes
->ObjectName
->Buffer
,
356 ObjectAttributes
->ObjectName
->Length
);
357 ret
= wine_server_call( req
);
358 *DirectoryHandle
= wine_server_ptr_handle( reply
->handle
);
364 /******************************************************************************
365 * NtCreateDirectoryObject [NTDLL.@]
366 * ZwCreateDirectoryObject [NTDLL.@]
368 * Create a namespace directory object.
371 * DirectoryHandle [O] Destination for the new directory handle
372 * DesiredAccess [I] Desired access to the directory
373 * ObjectAttributes [I] Structure describing the directory
376 * Success: ERROR_SUCCESS.
377 * Failure: An NTSTATUS error code.
379 NTSTATUS WINAPI
NtCreateDirectoryObject(PHANDLE DirectoryHandle
, ACCESS_MASK DesiredAccess
,
380 POBJECT_ATTRIBUTES ObjectAttributes
)
383 TRACE("(%p,0x%08x,%s)\n", DirectoryHandle
, DesiredAccess
, debugstr_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
= wine_server_obj_handle( 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
= wine_server_ptr_handle( 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
= wine_server_obj_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,%s)\n",LinkHandle
, DesiredAccess
, debugstr_ObjectAttributes(ObjectAttributes
));
492 if (!LinkHandle
) return STATUS_ACCESS_VIOLATION
;
493 if (!ObjectAttributes
) return STATUS_INVALID_PARAMETER
;
494 /* Have to test it here because server won't know difference between
495 * ObjectName == NULL and ObjectName == "" */
496 if (!ObjectAttributes
->ObjectName
)
498 if (ObjectAttributes
->RootDirectory
)
499 return STATUS_OBJECT_NAME_INVALID
;
501 return STATUS_OBJECT_PATH_SYNTAX_BAD
;
504 SERVER_START_REQ(open_symlink
)
506 req
->access
= DesiredAccess
;
507 req
->attributes
= ObjectAttributes
->Attributes
;
508 req
->rootdir
= wine_server_obj_handle( ObjectAttributes
->RootDirectory
);
509 if (ObjectAttributes
->ObjectName
)
510 wine_server_add_data(req
, ObjectAttributes
->ObjectName
->Buffer
,
511 ObjectAttributes
->ObjectName
->Length
);
512 ret
= wine_server_call( req
);
513 *LinkHandle
= wine_server_ptr_handle( reply
->handle
);
519 /******************************************************************************
520 * NtCreateSymbolicLinkObject [NTDLL.@]
521 * ZwCreateSymbolicLinkObject [NTDLL.@]
523 * Open a namespace symbolic link object.
526 * SymbolicLinkHandle [O] Destination for the new symbolic link handle
527 * DesiredAccess [I] Desired access to the symbolic link
528 * ObjectAttributes [I] Structure describing the symbolic link
529 * TargetName [I] Name of the target symbolic link points to
532 * Success: ERROR_SUCCESS.
533 * Failure: An NTSTATUS error code.
535 NTSTATUS WINAPI
NtCreateSymbolicLinkObject(OUT PHANDLE SymbolicLinkHandle
,IN ACCESS_MASK DesiredAccess
,
536 IN POBJECT_ATTRIBUTES ObjectAttributes
,
537 IN PUNICODE_STRING TargetName
)
541 if (!SymbolicLinkHandle
|| !TargetName
) return STATUS_ACCESS_VIOLATION
;
542 if (!TargetName
->Buffer
) return STATUS_INVALID_PARAMETER
;
544 TRACE("(%p,0x%08x,%s -> %s)\n", SymbolicLinkHandle
, DesiredAccess
,
545 debugstr_ObjectAttributes(ObjectAttributes
), debugstr_us(TargetName
));
547 SERVER_START_REQ(create_symlink
)
549 req
->access
= DesiredAccess
;
550 req
->attributes
= ObjectAttributes
? ObjectAttributes
->Attributes
: 0;
551 req
->rootdir
= wine_server_obj_handle( ObjectAttributes
? ObjectAttributes
->RootDirectory
: 0 );
552 if (ObjectAttributes
&& ObjectAttributes
->ObjectName
)
554 req
->name_len
= ObjectAttributes
->ObjectName
->Length
;
555 wine_server_add_data(req
, ObjectAttributes
->ObjectName
->Buffer
,
556 ObjectAttributes
->ObjectName
->Length
);
560 wine_server_add_data(req
, TargetName
->Buffer
, TargetName
->Length
);
561 ret
= wine_server_call( req
);
562 *SymbolicLinkHandle
= wine_server_ptr_handle( reply
->handle
);
568 /******************************************************************************
569 * NtQuerySymbolicLinkObject [NTDLL.@]
570 * ZwQuerySymbolicLinkObject [NTDLL.@]
572 * Query a namespace symbolic link object target name.
575 * LinkHandle [I] Handle to a symbolic link object
576 * LinkTarget [O] Destination for the symbolic link target
577 * ReturnedLength [O] Size of returned data
580 * Success: ERROR_SUCCESS.
581 * Failure: An NTSTATUS error code.
583 NTSTATUS WINAPI
NtQuerySymbolicLinkObject(IN HANDLE LinkHandle
, IN OUT PUNICODE_STRING LinkTarget
,
584 OUT PULONG ReturnedLength OPTIONAL
)
587 TRACE("(%p,%p,%p)\n", LinkHandle
, LinkTarget
, ReturnedLength
);
589 if (!LinkTarget
) return STATUS_ACCESS_VIOLATION
;
591 SERVER_START_REQ(query_symlink
)
593 req
->handle
= wine_server_obj_handle( LinkHandle
);
594 wine_server_set_reply( req
, LinkTarget
->Buffer
, LinkTarget
->MaximumLength
);
595 if (!(ret
= wine_server_call( req
)))
597 LinkTarget
->Length
= wine_server_reply_size(reply
);
598 if (ReturnedLength
) *ReturnedLength
= LinkTarget
->Length
;
605 /******************************************************************************
606 * NtAllocateUuids [NTDLL.@]
608 NTSTATUS WINAPI
NtAllocateUuids(
609 PULARGE_INTEGER Time
,
613 FIXME("(%p,%p,%p), stub.\n", Time
, Range
, Sequence
);
617 /**************************************************************************
618 * NtMakeTemporaryObject [NTDLL.@]
619 * ZwMakeTemporaryObject [NTDLL.@]
621 * Make a permanent object temporary.
624 * Handle [I] handle to permanent object
627 * Success: STATUS_SUCCESS.
628 * Failure: An NTSTATUS error code.
630 NTSTATUS WINAPI
NtMakeTemporaryObject( HANDLE Handle
)
632 FIXME("(%p), stub.\n", Handle
);
633 return STATUS_SUCCESS
;