FsRtlQueryInformationFile-Funktion (ntifs.h)
FsRtlQueryInformationFile erstellt eine explizite Dateiabfrageinformation IRP (IRP_MJ_QUERY_INFORMATION), sendet sie nach unten, wartet synchron darauf, bis sie abgeschlossen ist, und gibt das Ergebnis zurück. Mit dieser Funktion kann der Aufrufer diese Aktion durch FileObject- anstelle von Handle ausführen.
Syntax
NTSTATUS FsRtlQueryInformationFile(
[in] PFILE_OBJECT FileObject,
[out] PVOID FileInformation,
[in] ULONG Length,
[in] FILE_INFORMATION_CLASS FileInformationClass,
[out] PULONG RetFileInformationSize
);
Parameter
[in] FileObject
Zeigen Sie auf die FILE_OBJECT, um den Vorgang zu senden.
[out] FileInformation
Zeigen Sie auf einen vom Aufrufer zugewiesenen Puffer, um die abgefragten Dateiinformationen zu empfangen.
[in] Length
Größe in Byte des Puffers, auf den FileInformation verweist.
[in] FileInformationClass
Ein FILE_INFORMATION_CLASS Wert, der den Typ der abgefragten Dateiinformationen angibt.
[out] RetFileInformationSize
Empfängt die Anzahl der geschriebenen (zurückgegebenen) Bytes in den Puffer, auf die FileInformation verweist.
Rückgabewert
FsRtlKernelFsControlFile gibt STATUS_SUCCESS oder einen entsprechenden NTSTATUS-Wert wie einen der folgenden zurück.
| Wert | Bedeutung |
|---|---|
| STATUS_INSUFFICIENT_RESOURCES | Ein Poolzuweisungsfehler ist aufgetreten. |
| STATUS_INVALID_PARAMETER | Ein ungültiger Parameter wurde bereitgestellt (z. B. ein ungültiger FileObject-). |
Bemerkungen
Bei dieser Routine wird davon ausgegangen, dass alle in Puffern übergebenen Puffer Kernelmoduspuffer sind.
Anforderungen
| Anforderung | Wert |
|---|---|
| Header- | ntifs.h |