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
;
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
= 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
= source_process
;
260 req
->src_handle
= source
;
261 req
->dst_process
= 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
= 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
= 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)\n", DirectoryHandle
, DesiredAccess
);
336 dump_ObjectAttributes(ObjectAttributes
);
338 if (!DirectoryHandle
) return STATUS_ACCESS_VIOLATION
;
339 if (!ObjectAttributes
) return STATUS_INVALID_PARAMETER
;
340 /* Have to test it here because server won't know difference between
341 * ObjectName == NULL and ObjectName == "" */
342 if (!ObjectAttributes
->ObjectName
)
344 if (ObjectAttributes
->RootDirectory
)
345 return STATUS_OBJECT_NAME_INVALID
;
347 return STATUS_OBJECT_PATH_SYNTAX_BAD
;
350 SERVER_START_REQ(open_directory
)
352 req
->access
= DesiredAccess
;
353 req
->attributes
= ObjectAttributes
->Attributes
;
354 req
->rootdir
= ObjectAttributes
->RootDirectory
;
355 if (ObjectAttributes
->ObjectName
)
356 wine_server_add_data(req
, ObjectAttributes
->ObjectName
->Buffer
,
357 ObjectAttributes
->ObjectName
->Length
);
358 ret
= wine_server_call( req
);
359 *DirectoryHandle
= reply
->handle
;
365 /******************************************************************************
366 * NtCreateDirectoryObject [NTDLL.@]
367 * ZwCreateDirectoryObject [NTDLL.@]
369 * Create a namespace directory object.
372 * DirectoryHandle [O] Destination for the new directory handle
373 * DesiredAccess [I] Desired access to the directory
374 * ObjectAttributes [I] Structure describing the directory
377 * Success: ERROR_SUCCESS.
378 * Failure: An NTSTATUS error code.
380 NTSTATUS WINAPI
NtCreateDirectoryObject(PHANDLE DirectoryHandle
, ACCESS_MASK DesiredAccess
,
381 POBJECT_ATTRIBUTES ObjectAttributes
)
384 TRACE("(%p,0x%08x)\n", DirectoryHandle
, DesiredAccess
);
385 dump_ObjectAttributes(ObjectAttributes
);
387 if (!DirectoryHandle
) return STATUS_ACCESS_VIOLATION
;
389 SERVER_START_REQ(create_directory
)
391 req
->access
= DesiredAccess
;
392 req
->attributes
= ObjectAttributes
? ObjectAttributes
->Attributes
: 0;
393 req
->rootdir
= ObjectAttributes
? ObjectAttributes
->RootDirectory
: 0;
394 if (ObjectAttributes
&& ObjectAttributes
->ObjectName
)
395 wine_server_add_data(req
, ObjectAttributes
->ObjectName
->Buffer
,
396 ObjectAttributes
->ObjectName
->Length
);
397 ret
= wine_server_call( req
);
398 *DirectoryHandle
= reply
->handle
;
404 /******************************************************************************
405 * NtQueryDirectoryObject [NTDLL.@]
406 * ZwQueryDirectoryObject [NTDLL.@]
408 * Read information from a namespace directory.
411 * handle [I] Handle to a directory object
412 * buffer [O] Buffer to hold the read data
413 * size [I] Size of the buffer in bytes
414 * single_entry [I] If TRUE, return a single entry, if FALSE, return as many as fit in the buffer
415 * restart [I] If TRUE, start scanning from the start, if FALSE, scan from Context
416 * context [I/O] Indicates what point of the directory the scan is at
417 * ret_size [O] Caller supplied storage for the number of bytes written (or NULL)
420 * Success: ERROR_SUCCESS.
421 * Failure: An NTSTATUS error code.
423 NTSTATUS WINAPI
NtQueryDirectoryObject(HANDLE handle
, PDIRECTORY_BASIC_INFORMATION buffer
,
424 ULONG size
, BOOLEAN single_entry
, BOOLEAN restart
,
425 PULONG context
, PULONG ret_size
)
429 if (restart
) *context
= 0;
433 if (size
<= sizeof(*buffer
) + 2*sizeof(WCHAR
)) return STATUS_BUFFER_OVERFLOW
;
435 SERVER_START_REQ( get_directory_entry
)
437 req
->handle
= handle
;
438 req
->index
= *context
;
439 wine_server_set_reply( req
, buffer
+ 1, size
- sizeof(*buffer
) - 2*sizeof(WCHAR
) );
440 if (!(ret
= wine_server_call( req
)))
442 buffer
->ObjectName
.Buffer
= (WCHAR
*)(buffer
+ 1);
443 buffer
->ObjectName
.Length
= reply
->name_len
;
444 buffer
->ObjectName
.MaximumLength
= reply
->name_len
+ sizeof(WCHAR
);
445 buffer
->ObjectTypeName
.Buffer
= (WCHAR
*)(buffer
+ 1) + reply
->name_len
/sizeof(WCHAR
) + 1;
446 buffer
->ObjectTypeName
.Length
= wine_server_reply_size( reply
) - reply
->name_len
;
447 buffer
->ObjectTypeName
.MaximumLength
= buffer
->ObjectTypeName
.Length
+ sizeof(WCHAR
);
448 /* make room for the terminating null */
449 memmove( buffer
->ObjectTypeName
.Buffer
, buffer
->ObjectTypeName
.Buffer
- 1,
450 buffer
->ObjectTypeName
.Length
);
451 buffer
->ObjectName
.Buffer
[buffer
->ObjectName
.Length
/sizeof(WCHAR
)] = 0;
452 buffer
->ObjectTypeName
.Buffer
[buffer
->ObjectTypeName
.Length
/sizeof(WCHAR
)] = 0;
458 *ret_size
= buffer
->ObjectName
.MaximumLength
+ buffer
->ObjectTypeName
.MaximumLength
+ sizeof(*buffer
);
462 FIXME("multiple entries not implemented\n");
463 ret
= STATUS_NOT_IMPLEMENTED
;
473 /******************************************************************************
474 * NtOpenSymbolicLinkObject [NTDLL.@]
475 * ZwOpenSymbolicLinkObject [NTDLL.@]
477 * Open a namespace symbolic link object.
480 * LinkHandle [O] Destination for the new symbolic link handle
481 * DesiredAccess [I] Desired access to the symbolic link
482 * ObjectAttributes [I] Structure describing the symbolic link
485 * Success: ERROR_SUCCESS.
486 * Failure: An NTSTATUS error code.
488 NTSTATUS WINAPI
NtOpenSymbolicLinkObject(OUT PHANDLE LinkHandle
, IN ACCESS_MASK DesiredAccess
,
489 IN POBJECT_ATTRIBUTES ObjectAttributes
)
492 TRACE("(%p,0x%08x,%p)\n",LinkHandle
, DesiredAccess
, ObjectAttributes
);
493 dump_ObjectAttributes(ObjectAttributes
);
495 if (!LinkHandle
) return STATUS_ACCESS_VIOLATION
;
496 if (!ObjectAttributes
) return STATUS_INVALID_PARAMETER
;
497 /* Have to test it here because server won't know difference between
498 * ObjectName == NULL and ObjectName == "" */
499 if (!ObjectAttributes
->ObjectName
)
501 if (ObjectAttributes
->RootDirectory
)
502 return STATUS_OBJECT_NAME_INVALID
;
504 return STATUS_OBJECT_PATH_SYNTAX_BAD
;
507 SERVER_START_REQ(open_symlink
)
509 req
->access
= DesiredAccess
;
510 req
->attributes
= ObjectAttributes
->Attributes
;
511 req
->rootdir
= ObjectAttributes
->RootDirectory
;
512 if (ObjectAttributes
->ObjectName
)
513 wine_server_add_data(req
, ObjectAttributes
->ObjectName
->Buffer
,
514 ObjectAttributes
->ObjectName
->Length
);
515 ret
= wine_server_call( req
);
516 *LinkHandle
= reply
->handle
;
522 /******************************************************************************
523 * NtCreateSymbolicLinkObject [NTDLL.@]
524 * ZwCreateSymbolicLinkObject [NTDLL.@]
526 * Open a namespace symbolic link object.
529 * SymbolicLinkHandle [O] Destination for the new symbolic link handle
530 * DesiredAccess [I] Desired access to the symbolic link
531 * ObjectAttributes [I] Structure describing the symbolic link
532 * TargetName [I] Name of the target symbolic link points to
535 * Success: ERROR_SUCCESS.
536 * Failure: An NTSTATUS error code.
538 NTSTATUS WINAPI
NtCreateSymbolicLinkObject(OUT PHANDLE SymbolicLinkHandle
,IN ACCESS_MASK DesiredAccess
,
539 IN POBJECT_ATTRIBUTES ObjectAttributes
,
540 IN PUNICODE_STRING TargetName
)
543 TRACE("(%p,0x%08x,%p, -> %s)\n", SymbolicLinkHandle
, DesiredAccess
, ObjectAttributes
,
544 debugstr_us(TargetName
));
545 dump_ObjectAttributes(ObjectAttributes
);
547 if (!SymbolicLinkHandle
|| !TargetName
) return STATUS_ACCESS_VIOLATION
;
548 if (!TargetName
->Buffer
) return STATUS_INVALID_PARAMETER
;
550 SERVER_START_REQ(create_symlink
)
552 req
->access
= DesiredAccess
;
553 req
->attributes
= ObjectAttributes
? ObjectAttributes
->Attributes
: 0;
554 req
->rootdir
= ObjectAttributes
? ObjectAttributes
->RootDirectory
: 0;
555 if (ObjectAttributes
&& ObjectAttributes
->ObjectName
)
557 req
->name_len
= ObjectAttributes
->ObjectName
->Length
;
558 wine_server_add_data(req
, ObjectAttributes
->ObjectName
->Buffer
,
559 ObjectAttributes
->ObjectName
->Length
);
563 wine_server_add_data(req
, TargetName
->Buffer
, TargetName
->Length
);
564 ret
= wine_server_call( req
);
565 *SymbolicLinkHandle
= reply
->handle
;
571 /******************************************************************************
572 * NtQuerySymbolicLinkObject [NTDLL.@]
573 * ZwQuerySymbolicLinkObject [NTDLL.@]
575 * Query a namespace symbolic link object target name.
578 * LinkHandle [I] Handle to a symbolic link object
579 * LinkTarget [O] Destination for the symbolic link target
580 * ReturnedLength [O] Size of returned data
583 * Success: ERROR_SUCCESS.
584 * Failure: An NTSTATUS error code.
586 NTSTATUS WINAPI
NtQuerySymbolicLinkObject(IN HANDLE LinkHandle
, IN OUT PUNICODE_STRING LinkTarget
,
587 OUT PULONG ReturnedLength OPTIONAL
)
590 TRACE("(%p,%p,%p)\n", LinkHandle
, LinkTarget
, ReturnedLength
);
592 if (!LinkTarget
) return STATUS_ACCESS_VIOLATION
;
594 SERVER_START_REQ(query_symlink
)
596 req
->handle
= LinkHandle
;
597 wine_server_set_reply( req
, LinkTarget
->Buffer
, LinkTarget
->MaximumLength
);
598 if (!(ret
= wine_server_call( req
)))
600 LinkTarget
->Length
= wine_server_reply_size(reply
);
601 if (ReturnedLength
) *ReturnedLength
= LinkTarget
->Length
;
608 /******************************************************************************
609 * NtAllocateUuids [NTDLL.@]
611 NTSTATUS WINAPI
NtAllocateUuids(
612 PULARGE_INTEGER Time
,
616 FIXME("(%p,%p,%p), stub.\n", Time
, Range
, Sequence
);