IoQueryFileDosDeviceName 함수(ntifs.h)

IoQueryFileDosDeviceName 루틴은 파일에 대한 MS-DOS 디바이스 이름을 검색합니다.

구문

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

[in] FileObject

파일의 파일 개체에 대한 포인터입니다.

[out] ObjectNameInformation

새로 할당된 OBJECT_NAME_INFORMATION 구조체에 대한 반환된 포인터입니다. 이 구조는 MS-DOS 디바이스 이름 정보를 사용하여 성공적인 반환에 채워집니다. 구조체는 다음과 같이 정의됩니다.

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

참고 이 구조체는 결국 ExFreePool을 호출하여 해제되어야 합니다.

IoQueryFileDosDeviceName 은 STATUS_SUCCESS 또는 오류 NTSTATUS 값(예: STATUS_INSUFFICIENT_RESOURCES)을 반환합니다.

MS-DOS 이름에 대한 자세한 내용은 SDK(플랫폼 소프트웨어 개발 키트) 설명서의 파일 및 I/O 섹션을 참조하세요.