Condividi tramite


Funzione IoQueryFileDosDeviceName (ntifs.h)

La routine IoQueryFileDosDeviceName recupera un nome del dispositivo MS-DOS per un file.

Sintassi

NTSTATUS IoQueryFileDosDeviceName(
  [in]  PFILE_OBJECT             FileObject,
  [out] POBJECT_NAME_INFORMATION *ObjectNameInformation
);

Parametri

[in] FileObject

Puntatore a un oggetto file per il file.

[out] ObjectNameInformation

Puntatore restituito a una struttura di OBJECT_NAME_INFORMATION appena allocata. Questa struttura viene compilata in caso di esito positivo con le informazioni sul nome del dispositivo MS-DOS. La struttura è definita come segue:

typedef struct _OBJECT_NAME_INFORMATION {
    UNICODE_STRING Name;
} OBJECT_NAME_INFORMATION, *POBJECT_NAME_INFORMATION;
Nota Questa struttura deve essere liberata chiamando ExFreePool.
 

Valore restituito

IoQueryFileDosDeviceName restituisce STATUS_SUCCESS o un valore NTSTATUS di errore, ad esempio STATUS_INSUFFICIENT_RESOURCES.

Commenti

Per altre informazioni sui nomi MS-DOS, vedere la sezione File e I/O della documentazione di Platform Software Development Kit (SDK).

Requisiti

Requisito Valore
Client minimo supportato Questa routine è disponibile a partire daWindows XP.
Piattaforma di destinazione Universale
Intestazione ntifs.h (include Ntifs.h, Fltkernel.h)
Libreria NtosKrnl.lib
DLL NtosKrnl.exe
IRQL PASSIVE_LEVEL

Vedi anche

UNICODE_STRING