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;

Valor de retorno

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

Observações

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

Requisitos

Consulte também

UNICODE_STRING