1 /* $Id: dir.c,v 1.11 2001/11/02 22:22:33 hbirr Exp $
3 * COPYRIGHT: See COPYING in the top level directory
4 * PROJECT: ReactOS kernel
5 * FILE: ntoskrnl/io/dir.c
6 * PURPOSE: Directory functions
7 * PROGRAMMER: David Welch (welch@mcmail.com)
12 /* INCLUDES *****************************************************************/
14 #include <ddk/ntddk.h>
15 #include <internal/io.h>
18 #include <internal/debug.h>
20 /* FUNCTIONS *****************************************************************/
26 NtNotifyChangeDirectoryFile (
28 IN HANDLE Event OPTIONAL
,
29 IN PIO_APC_ROUTINE ApcRoutine OPTIONAL
,
30 IN PVOID ApcContext OPTIONAL
,
31 OUT PIO_STATUS_BLOCK IoStatusBlock
,
34 IN ULONG CompletionFilter
,
46 IN HANDLE PEvent OPTIONAL
,
47 IN PIO_APC_ROUTINE ApcRoutine OPTIONAL
,
48 IN PVOID ApcContext OPTIONAL
,
49 OUT PIO_STATUS_BLOCK IoStatusBlock
,
50 OUT PVOID FileInformation
,
52 IN FILE_INFORMATION_CLASS FileInformationClass
,
53 IN BOOLEAN ReturnSingleEntry
,
54 IN PUNICODE_STRING FileName OPTIONAL
,
55 IN BOOLEAN RestartScan
58 * FUNCTION: Queries a directory file.
60 * FileHandle = Handle to a directory file
61 * EventHandle = Handle to the event signaled on completion
62 * ApcRoutine = Asynchroneous procedure callback, called on completion
63 * ApcContext = Argument to the apc.
64 * IoStatusBlock = Caller supplies storage for extended status information.
65 * FileInformation = Caller supplies storage for the resulting information.
67 * FileNameInformation FILE_NAMES_INFORMATION
68 * FileDirectoryInformation FILE_DIRECTORY_INFORMATION
69 * FileFullDirectoryInformation FILE_FULL_DIRECTORY_INFORMATION
70 * FileBothDirectoryInformation FILE_BOTH_DIR_INFORMATION
72 * Length = Size of the storage supplied
73 * FileInformationClass = Indicates the type of information requested.
74 * ReturnSingleEntry = Specify true if caller only requests the first
76 * FileName = Initial directory name to query, that may contain wild
78 * RestartScan = Number of times the action should be repeated
79 * RETURNS: Status [ STATUS_SUCCESS, STATUS_ACCESS_DENIED, STATUS_INSUFFICIENT_RESOURCES,
80 * STATUS_INVALID_PARAMETER, STATUS_INVALID_DEVICE_REQUEST, STATUS_BUFFER_OVERFLOW,
81 * STATUS_INVALID_INFO_CLASS, STATUS_NO_SUCH_FILE, STATUS_NO_MORE_FILES ]
85 PDEVICE_OBJECT DeviceObject
;
86 PFILE_OBJECT FileObject
;
89 PIO_STACK_LOCATION IoStack
;
92 DPRINT("NtQueryDirectoryFile()\n");
94 Status
= ObReferenceObjectByHandle(FileHandle
,
101 if (Status
!= STATUS_SUCCESS
)
103 ObDereferenceObject(FileObject
);
106 KeInitializeEvent(&Event
,NotificationEvent
,FALSE
);
107 DeviceObject
= FileObject
->DeviceObject
;
109 Irp
= IoAllocateIrp(DeviceObject
->StackSize
, TRUE
);
112 ObDereferenceObject(FileObject
);
113 return STATUS_UNSUCCESSFUL
;
117 Irp
->UserIosb
= &IoSB
;
118 Irp
->UserEvent
= &Event
;
119 Irp
->UserBuffer
=FileInformation
;
121 IoStack
= IoGetNextIrpStackLocation(Irp
);
123 IoStack
->MajorFunction
= IRP_MJ_DIRECTORY_CONTROL
;
124 IoStack
->MinorFunction
= IRP_MN_QUERY_DIRECTORY
;
126 IoStack
->Control
= 0;
127 IoStack
->DeviceObject
= DeviceObject
;
128 IoStack
->FileObject
= FileObject
;
132 IoStack
->Flags
= IoStack
->Flags
| SL_RESTART_SCAN
;
134 if (ReturnSingleEntry
)
136 IoStack
->Flags
= IoStack
->Flags
| SL_RETURN_SINGLE_ENTRY
;
138 if (((PFILE_DIRECTORY_INFORMATION
)FileInformation
)->FileIndex
!= 0)
140 IoStack
->Flags
= IoStack
->Flags
| SL_INDEX_SPECIFIED
;
143 IoStack
->Parameters
.QueryDirectory
.FileInformationClass
=
144 FileInformationClass
;
145 IoStack
->Parameters
.QueryDirectory
.FileName
= FileName
;
146 IoStack
->Parameters
.QueryDirectory
.Length
= Length
;
148 Status
= IoCallDriver(FileObject
->DeviceObject
,Irp
);
149 if (Status
==STATUS_PENDING
&& (FileObject
->Flags
& FO_SYNCHRONOUS_IO
))
151 if (FileObject
->Flags
& FO_ALERTABLE_IO
)
153 KeWaitForSingleObject(&Event
,Executive
,KernelMode
,TRUE
,NULL
);
157 KeWaitForSingleObject(&Event
,Executive
,KernelMode
,FALSE
,NULL
);
159 Status
= IoSB
.Status
;
163 *IoStatusBlock
= IoSB
;
168 NTSTATUS STDCALL
NtQueryOleDirectoryFile(VOID
)