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