Função IoQueryFileDosDeviceName (ntifs.h)

A rotina IoQueryFileDosDeviceName recupera um nome de dispositivo MS-DOS para um arquivo.

Sintaxe

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

Parâmetros

[in] FileObject

Ponteiro para um objeto de arquivo para o arquivo.

[out] ObjectNameInformation

Um ponteiro retornado para uma estrutura de OBJECT_NAME_INFORMATION recém-alocada. Essa estrutura é preenchida no retorno bem-sucedido com as informações de nome do dispositivo MS-DOS. A estrutura é definida da seguinte maneira:

typedef struct _OBJECT_NAME_INFORMATION {
    UNICODE_STRING Name;
} OBJECT_NAME_INFORMATION, *POBJECT_NAME_INFORMATION;

Nota Essa estrutura deve eventualmente ser liberada chamando ExFreePool.

 

Retornar valor

IoQueryFileDosDeviceName retorna STATUS_SUCCESS ou um valor NTSTATUS de erro, como STATUS_INSUFFICIENT_RESOURCES.

Comentários

Para obter mais informações sobre nomes MS-DOS, consulte a seção Arquivos e E/S da documentação do SDK (Platform Software Development Kit).

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Essa rotina está disponível a partir do XP doWindows.
Plataforma de Destino	Universal
Cabeçalho	ntifs.h (inclua Ntifs.h, Fltkernel.h)
Biblioteca	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL

Confira também

UNICODE_STRING