Funzione ZwQueryInformationFile (wdm.h)

La routine ZwQueryInformationFile restituisce vari tipi di informazioni su un oggetto file.

Sintassi

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

Parametri

[in] FileHandle

Handle in un oggetto file. L'handle viene creato da una chiamata riuscita a ZwCreateFile o ZwOpenFile.

[out] IoStatusBlock

Puntatore a una struttura IO_STATUS_BLOCK che riceve lo stato di completamento finale e informazioni sull'operazione. Il membro Information riceve il numero di byte che questa routine scrive effettivamente nel buffer FileInformation .

[out] FileInformation

Puntatore a un buffer allocato dal chiamante in cui la routine scrive le informazioni richieste sull'oggetto file. Il parametro FileInformationClass specifica il tipo di informazioni richieste dal chiamante.

[in] Length

Dimensioni, in byte, del buffer a cui punta FileInformation.

[in] FileInformationClass

Specifica il tipo di informazioni da restituire sul file, nel buffer a cui punta FileInformation . I driver intermedi e del dispositivo possono specificare uno dei valori di FILE_INFORMATION_CLASS seguenti.

Valore restituito

ZwQueryInformationFile restituisce STATUS_SUCCESS o un codice di errore NTSTATUS appropriato.

Osservazioni:

ZwQueryInformationFile restituisce informazioni sull'oggetto file specificato. Si noti che restituisce zero in qualsiasi membro di una struttura FILE_XXX_INFORMATION non supportata da un particolare dispositivo o file system.

Quando FileInformationClass = FileNameInformation, il nome file viene restituito nella struttura FILE_NAME_INFORMATION . La sintassi precisa del nome file dipende da diversi fattori:

• Se il file è stato aperto inviando un percorso completo a ZwCreateFile, ZwQueryInformationFile restituisce il percorso completo.

• Se l'handle ObjectAttributes-RootDirectory> è stato aperto per nome in una chiamata a ZwCreateFile e successivamente il file è stato aperto da ZwCreateFile rispetto a questo handle di directory radice, ZwQueryInformationFile restituisce il percorso completo.

• Se l'handle ObjectAttributes-RootDirectory> è stato aperto dall'ID file (usando il flag FILE_OPEN_BY_FILE_ID) in una chiamata a ZwCreateFile e successivamente il file è stato aperto da ZwCreateFile rispetto a questo handle della directory radice, ZwQueryInformationFile restituisce il percorso relativo.

• Tuttavia, se l'utente ha SeChangeNotifyPrivilege, ZwQueryInformationFile restituisce il percorso completo in tutti i casi.

• Se viene restituito solo il percorso relativo, la stringa del nome file non inizierà con una barra rovesciata.

• Se vengono restituiti il percorso completo e il nome del file, la stringa inizierà con una singola barra rovesciata, indipendentemente dal relativo percorso. Il file C:\dir1\dir2\filename.ext verrà quindi visualizzato come \dir1\dir2\filename.ext, mentre il file \server\share\dir1\dir2\filename.ext verrà visualizzato come \server\share\dir1\dir2\filename.ext.

Se ZwQueryInformationFile ha esito negativo a causa di un overflow del buffer, i driver che implementano FileNameInformation devono restituire il numero di caratteri WCHAR del nome file che verranno inseriti nel buffer e specificare la lunghezza intera necessaria nel parametro FileNameLength della struttura FILE_NAME_INFORMATION . È consigliabile eseguire nuovamente la query usando la lunghezza del nome file in modo da poter recuperare il nome file completo. I driver che non seguono questo modello potrebbero richiedere un aumento graduale della lunghezza fino a quando non recuperano il nome completo del file. Per altre informazioni sull'uso dei file, vedere Uso di file in un driver.

I chiamanti di ZwQueryInformationFile devono essere in esecuzione in IRQL = PASSIVE_LEVEL e con API del kernel speciali abilitate.

Se la chiamata a questa funzione si verifica in modalità utente, devi usare il nome "NtQueryInformationFile" anziché "ZwQueryInformationFile".

Per le chiamate da driver in modalità kernel, le NtXxx e ZwXxx versioni di una routine di Windows Native System Services possono comportarsi in modo diverso nel modo in cui gestiscono e interpretano i parametri di input. Per altre informazioni sulla relazione tra le versioni NtXxx e ZwXxx di una routine, vedere Using Nt and Zw Versions of the Native System Services Routines.

Requisiti

Vedere anche

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

ZwCreateFile

ZwSetInformationFile