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 |