Functia ZwQueryInformationFile (wdm.h) – drivere Windows

• 30.04.2018
• 5 minute de citit

In acest articol

ZwQueryInformationFile Rutina returneaza diferite tipuri de informatii despre un obiect fisier.

Sintaxa

NTSYSAPI NTSTATUS ZwQueryInformationFile (HANDLE FileHandle, PIO_STATUS_BLOCK IoStatusBlock, PVOID FileInformation, ULONG Length, FILE_INFORMATION_CLASS FileInformationClass);

Parametrii

FileHandle

[in] Maner la un obiect de fisier. Handle-ul este creat de un apel reusit catre ZwCreateFile sau ZwOpenFile.

IoStatusBlock

[out] Pointer catre o structura IO_STATUS_BLOCK care primeste starea finala finala si informatii despre operatie. Membrul Information primeste numarul de octeti pe care aceasta rutina il scrie de fapt in bufferul FileInformation .

FileInformation

[out] Pointer catre un buffer alocat apelantului in care rutina scrie informatiile solicitate despre obiectul fisierului. FileInformationClass parametru specifica tipul de informatii pe care solicitarile apelantului.

Lungime

[in] Dimensiunea, in octeti, a bufferului indicat de FileInformation .

FileInformationClass

[in] Specifica tipul de informatii care trebuie returnate despre fisier, in bufferul catre care indica FileInformation . Dispozitivele si driverele intermediare pot specifica oricare dintre urmatoarele valori FILE_INFORMATION_CLASS.

Valoare FILE_INFORMATION_CLASS Tipul informatiilor returnate FileAccessInformation O structura FILE_ACCESS_INFORMATION. Aceasta structura contine o masca de acces. Pentru mai multe informatii despre mastile de acces, consultati ACCESS_MASK. FileAlignmentInformation O structura FILE_ALIGNMENT_INFORMATION. Apelantul poate interoga aceste informatii atata timp cat fisierul este deschis, fara nicio cerinta speciala pentru DesiredAccess . Aceste informatii sunt utile daca fisierul a fost deschis cu semnalizatorul FILE_NO_INTERMEDIATE_BUFFERING specificat in parametrul CreateOptions . FileAllInformation O structura FILE_ALL_INFORMATION. Prin combinarea mai multor structuri de informatii despre fisiere intr-o singura structura, FILE_ALL_INFORMATIONreduce numarul de interogari necesare pentru a obtine informatii despre un fisier. FileAttributeTagInformation O structura FILE_ATTRIBUTE_TAG_INFORMATION. Apelantul trebuie sa fi deschis fisierul cu semnalizatorul FILE_READ_ATTRIBUTES specificat in parametrul DesiredAccess . FileBasicInformation O structura FILE_BASIC_INFORMATION. Apelantul trebuie sa fi deschis fisierul cu semnalizatorul FILE_READ_ATTRIBUTES specificat in parametrul DesiredAccess . FileEaInformation O structura FILE_EA_INFORMATION. Aceasta structura specifica dimensiunea blocului de atribute extinse care este asociat fisierului. FileInternalInformationO structura FILE_INTERNAL_INFORMATION. Aceasta structura specifica un ID de fisier pe 64 de biti care identifica in mod unic un fisier in NTFS. Pe alte sisteme de fisiere, nu este garantat ca acest ID de fisier este unic. FileIoPriorityHintInformation O structura FILE_IO_PRIORITY_HINT_INFORMATION. Apelantul trebuie sa fi deschis fisierul cu semnalizatorul FILE_READ_DATA specificat in parametrul DesiredAccess . FileModeInformation O structura FILE_MODE_INFORMATION. Aceasta structura contine un set de steaguri care specifica modul in care fisierul poate fi accesat. Aceste semnalizatoare sunt un subset de optiuni care pot fi specificate in parametrul CreateOptions al rutinei IoCreateFile. FileNameInformationO structura FILE_NAME_INFORMATION. Structura poate contine calea completa a fisierului sau doar o parte din aceasta. Apelantul poate interoga aceste informatii atata timp cat fisierul este deschis, fara nicio cerinta speciala pentru DesiredAccess .

Pentru mai multe informatii despre sintaxa numelui fisierului, consultati sectiunea Observatii mai tarziu in acest subiect.

FileNetworkOpenInformation O structura FILE_NETWORK_OPEN_INFORMATION. Apelantul trebuie sa fi deschis fisierul cu semnalizatorul FILE_READ_ATTRIBUTES specificat in parametrul DesiredAccess . FilePositionInformation O structura FILE_POSITION_INFORMATION. Apelantul trebuie sa fi deschis fisierul cu pavilionul DesiredAccess FILE_READ_DATA sau FILE_WRITE_DATA specificat in parametrul DesiredAccess si cu pavilionul FILE_SYNCHRONOUS_IO_ALERT sau FILE_SYNCHRONOUS_IO_NONALERT specificat in parametrul CreateOptions . FileStandardInformation O structura FILE_STANDARD_INFORMATION. Apelantul poate interoga aceste informatii atata timp cat fisierul este deschis, fara cerinte speciale pentruAcces dorit . FileIsRemoteDeviceInformation O structura FILE_IS_REMOTE_DEVICE_INFORMATION. Apelantul poate interoga aceste informatii atata timp cat fisierul este deschis, fara nicio cerinta speciala pentru DesiredAccess .

Valoare returnata

ZwQueryInformationFile returneaza STATUS_SUCCESS sau un cod de eroare NTSTATUS adecvat.

ZwQueryInformationFile returneaza informatii despre obiectul fisier specificat. Retineti ca returneaza zero in orice membru al unei FILE_ XXX _INFORMATION structura care nu este sustinuta de un anumit sistem de dispozitiv sau un fisier.

Cand FileInformationClass = FileNameInformation , numele fisierului este returnat in structura FILE_NAME_INFORMATION. Sintaxa precisa a numelui fisierului depinde de o serie de factori:

• Daca ati deschis fisierul prin trimiterea unei cai complete catre ZwCreateFile, ZwQueryInformationFile returneaza acea cale completa.
• Daca manerul ObjectAttributes-> RootDirectory a fost deschis pe nume intr-un apel catre ZwCreateFile si ulterior fisierul a fost deschis de ZwCreateFile in raport cu acest handle de director radacina, ZwQueryInformationFile returneaza calea completa.
• Daca manerul ObjectAttributes-> RootDirectory a fost deschis de ID-ul fisierului (utilizand semnalizatorul FILE_OPEN_BY_FILE_ID) intr-un apel catre ZwCreateFile si ulterior fisierul a fost deschis de ZwCreateFile in raport cu acest handle de director radacina, ZwQueryInformationFile returneaza calea relativa.
• Cu toate acestea, daca utilizatorul are SeChangeNotifyPrivilege (descris in documentatia Microsoft Windows SDK), ZwQueryInformationFile returneaza calea completa in toate cazurile.
• Daca se returneaza numai calea relativa, sirul de nume de fisier nu va incepe cu o bara inversa.
• Daca se returneaza calea completa si numele fisierului, sirul va incepe cu o singura bara inversa, indiferent de locatia sa. Astfel, fisierul C: \ dir1 \ dir2 \ filename.ext va aparea ca \ dir1 \ dir2 \ filename.ext, in timp ce fisierul \\ server \ share \ dir1 \ dir2 \ filename.ext va aparea ca \ server \ share \ dir1 \ dir2 \ filename.ext.

Daca ZwQueryInformationFile esueaza din cauza unei depasiri a bufferului, driverele care implementeaza FileNameInformation ar trebui sa returneze cate caractere WCHAR din numele fisierului se vor potrivi in buffer si sa specifice lungimea completa care este necesara in parametrul FileNameLength al structurii FILE_NAME_INFORMATION. Ar trebui sa retransmiteti interogarea utilizand lungimea numelui fisierului, astfel incat sa puteti recupera numele complet al fisierului. Driverele care nu respecta acest model ar putea necesita o crestere treptata a lungimii pana cand vor recupera numele complet al fisierului. Pentru mai multe informatii despre lucrul cu fisiere, consultati Utilizarea fisierelor intr-un driver.

Apelantii ZwQueryInformationFile trebuie sa ruleze la IRQL = PASSIVE_LEVEL si cu APC-uri speciale de nucleu activate.

Nota   Daca apelul catre aceasta functie apare in modul utilizator, ar trebui sa utilizati numele ” NtQueryInformationFile ” in loc de ” ZwQueryInformationFile “.

Pentru apelurile de la driverele in modul kernel, versiunile Nt Xxx si Zw Xxx ale unei rutine Windows Native System Services se pot comporta diferit in modul in care gestioneaza si interpreteaza parametrii de intrare. Pentru mai multe informatii despre relatia dintre versiunile Nt Xxx si Zw Xxx ale unei rutine, consultati Utilizarea versiunilor Nt si Zw ale rutinelor Native System Services.

Cerinte

    Client minim acceptat Disponibil incepand cu Windows 2000. Platforma tinta Header universal wdm.h (include Wdm.h, Ntddk.h, Ntifs.h) Biblioteca NtosKrnl.lib DLL NtosKrnl.exe IRQL PASSIVE_LEVEL (vezi sectiunea Observatii) Regulile de conformitate DDI PowerIrpDDis, HwStorPortProhibitedDDIs

Vezi si

FILE_ACCESS_INFORMATION

FILE_ALIGNMENT_INFORMATION

FILE_ALL_INFORMATION

FILE_ATTRIBUTE_TAG_INFORMATION

FILE_BASIC_INFORMATION

FILE_EA_INFORMATION

FILE_INTERNAL_INFORMATION

FILE_IO_PRIORITY_HINT_INFORMATION

FILE_IS_REMOTE_DEVICE_INFORMATION

FILE_MODE_INFORMATION

FILE_NAME_INFORMATION

FILE_NETWORK_OPEN_INFORMATION

FILE_POSITION_INFORMATION

FILE_STANDARD_INFORMATION

Utilizarea versiunilor Nt si Zw ale rutinelor Native System Services

ZwCreateFile

ZwSetInformationFile