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
);