296 lines
10 KiB
C
296 lines
10 KiB
C
/*++
|
|
|
|
Copyright (c) 1997-1999 Microsoft Corporation
|
|
|
|
Module Name:
|
|
|
|
mountmgr.h
|
|
|
|
Abstract:
|
|
|
|
This file defines the external mount point interface for administering
|
|
mount points.
|
|
|
|
Revision History:
|
|
|
|
--*/
|
|
|
|
#ifndef _MOUNTMGR_
|
|
#define _MOUNTMGR_
|
|
|
|
#if _MSC_VER > 1000
|
|
#pragma once
|
|
#endif
|
|
|
|
#ifndef FAR
|
|
#define FAR
|
|
#endif
|
|
|
|
#if (NTDDI_VERSION >= NTDDI_WIN2K)
|
|
|
|
#define MOUNTMGR_DEVICE_NAME L"\\Device\\MountPointManager"
|
|
#define MOUNTMGR_DOS_DEVICE_NAME L"\\\\.\\MountPointManager"
|
|
|
|
#define MOUNTMGRCONTROLTYPE 0x0000006D // 'm'
|
|
#define MOUNTDEVCONTROLTYPE 0x0000004D // 'M'
|
|
|
|
//
|
|
// These are the IOCTLs supported by the mount point manager.
|
|
//
|
|
|
|
#define IOCTL_MOUNTMGR_CREATE_POINT CTL_CODE(MOUNTMGRCONTROLTYPE, 0, METHOD_BUFFERED, FILE_READ_ACCESS | FILE_WRITE_ACCESS)
|
|
#define IOCTL_MOUNTMGR_DELETE_POINTS CTL_CODE(MOUNTMGRCONTROLTYPE, 1, METHOD_BUFFERED, FILE_READ_ACCESS | FILE_WRITE_ACCESS)
|
|
#define IOCTL_MOUNTMGR_QUERY_POINTS CTL_CODE(MOUNTMGRCONTROLTYPE, 2, METHOD_BUFFERED, FILE_ANY_ACCESS)
|
|
#define IOCTL_MOUNTMGR_DELETE_POINTS_DBONLY CTL_CODE(MOUNTMGRCONTROLTYPE, 3, METHOD_BUFFERED, FILE_READ_ACCESS | FILE_WRITE_ACCESS)
|
|
#define IOCTL_MOUNTMGR_NEXT_DRIVE_LETTER CTL_CODE(MOUNTMGRCONTROLTYPE, 4, METHOD_BUFFERED, FILE_READ_ACCESS | FILE_WRITE_ACCESS)
|
|
#define IOCTL_MOUNTMGR_AUTO_DL_ASSIGNMENTS CTL_CODE(MOUNTMGRCONTROLTYPE, 5, METHOD_BUFFERED, FILE_READ_ACCESS | FILE_WRITE_ACCESS)
|
|
#define IOCTL_MOUNTMGR_VOLUME_MOUNT_POINT_CREATED CTL_CODE(MOUNTMGRCONTROLTYPE, 6, METHOD_BUFFERED, FILE_READ_ACCESS | FILE_WRITE_ACCESS)
|
|
#define IOCTL_MOUNTMGR_VOLUME_MOUNT_POINT_DELETED CTL_CODE(MOUNTMGRCONTROLTYPE, 7, METHOD_BUFFERED, FILE_READ_ACCESS | FILE_WRITE_ACCESS)
|
|
#define IOCTL_MOUNTMGR_CHANGE_NOTIFY CTL_CODE(MOUNTMGRCONTROLTYPE, 8, METHOD_BUFFERED, FILE_READ_ACCESS)
|
|
#define IOCTL_MOUNTMGR_KEEP_LINKS_WHEN_OFFLINE CTL_CODE(MOUNTMGRCONTROLTYPE, 9, METHOD_BUFFERED, FILE_READ_ACCESS | FILE_WRITE_ACCESS)
|
|
#define IOCTL_MOUNTMGR_CHECK_UNPROCESSED_VOLUMES CTL_CODE(MOUNTMGRCONTROLTYPE, 10, METHOD_BUFFERED, FILE_READ_ACCESS)
|
|
#define IOCTL_MOUNTMGR_VOLUME_ARRIVAL_NOTIFICATION CTL_CODE(MOUNTMGRCONTROLTYPE, 11, METHOD_BUFFERED, FILE_READ_ACCESS)
|
|
|
|
//
|
|
// Input structure for IOCTL_MOUNTMGR_CREATE_POINT.
|
|
//
|
|
|
|
typedef struct _MOUNTMGR_CREATE_POINT_INPUT {
|
|
USHORT SymbolicLinkNameOffset;
|
|
USHORT SymbolicLinkNameLength;
|
|
USHORT DeviceNameOffset;
|
|
USHORT DeviceNameLength;
|
|
} MOUNTMGR_CREATE_POINT_INPUT, *PMOUNTMGR_CREATE_POINT_INPUT;
|
|
|
|
//
|
|
// Input structure for IOCTL_MOUNTMGR_DELETE_POINTS,
|
|
// IOCTL_MOUNTMGR_QUERY_POINTS, and IOCTL_MOUNTMGR_DELETE_POINTS_DBONLY.
|
|
//
|
|
|
|
typedef struct _MOUNTMGR_MOUNT_POINT {
|
|
ULONG SymbolicLinkNameOffset;
|
|
USHORT SymbolicLinkNameLength;
|
|
ULONG UniqueIdOffset;
|
|
USHORT UniqueIdLength;
|
|
ULONG DeviceNameOffset;
|
|
USHORT DeviceNameLength;
|
|
} MOUNTMGR_MOUNT_POINT, *PMOUNTMGR_MOUNT_POINT;
|
|
|
|
//
|
|
// Output structure for IOCTL_MOUNTMGR_DELETE_POINTS,
|
|
// IOCTL_MOUNTMGR_QUERY_POINTS, and IOCTL_MOUNTMGR_DELETE_POINTS_DBONLY.
|
|
//
|
|
|
|
typedef struct _MOUNTMGR_MOUNT_POINTS {
|
|
ULONG Size;
|
|
ULONG NumberOfMountPoints;
|
|
MOUNTMGR_MOUNT_POINT MountPoints[1];
|
|
} MOUNTMGR_MOUNT_POINTS, *PMOUNTMGR_MOUNT_POINTS;
|
|
|
|
//
|
|
// Input structure for IOCTL_MOUNTMGR_NEXT_DRIVE_LETTER.
|
|
//
|
|
|
|
typedef struct _MOUNTMGR_DRIVE_LETTER_TARGET {
|
|
USHORT DeviceNameLength;
|
|
WCHAR DeviceName[1];
|
|
} MOUNTMGR_DRIVE_LETTER_TARGET, *PMOUNTMGR_DRIVE_LETTER_TARGET;
|
|
|
|
//
|
|
// Output structure for IOCTL_MOUNTMGR_NEXT_DRIVE_LETTER.
|
|
//
|
|
|
|
typedef struct _MOUNTMGR_DRIVE_LETTER_INFORMATION {
|
|
BOOLEAN DriveLetterWasAssigned;
|
|
UCHAR CurrentDriveLetter;
|
|
} MOUNTMGR_DRIVE_LETTER_INFORMATION, *PMOUNTMGR_DRIVE_LETTER_INFORMATION;
|
|
|
|
//
|
|
// Input structure for IOCTL_MOUNTMGR_VOLUME_MOUNT_POINT_CREATED and
|
|
// IOCTL_MOUNTMGR_VOLUME_MOUNT_POINT_DELETED.
|
|
//
|
|
|
|
typedef struct _MOUNTMGR_VOLUME_MOUNT_POINT {
|
|
USHORT SourceVolumeNameOffset;
|
|
USHORT SourceVolumeNameLength;
|
|
USHORT TargetVolumeNameOffset;
|
|
USHORT TargetVolumeNameLength;
|
|
} MOUNTMGR_VOLUME_MOUNT_POINT, *PMOUNTMGR_VOLUME_MOUNT_POINT;
|
|
|
|
//
|
|
// Input structure for IOCTL_MOUNTMGR_CHANGE_NOTIFY.
|
|
// Output structure for IOCTL_MOUNTMGR_CHANGE_NOTIFY.
|
|
//
|
|
|
|
typedef struct _MOUNTMGR_CHANGE_NOTIFY_INFO {
|
|
ULONG EpicNumber;
|
|
} MOUNTMGR_CHANGE_NOTIFY_INFO, *PMOUNTMGR_CHANGE_NOTIFY_INFO;
|
|
|
|
//
|
|
// Input structure for IOCTL_MOUNTMGR_KEEP_LINKS_WHEN_OFFLINE,
|
|
// IOCTL_MOUNTMGR_VOLUME_ARRIVAL_NOTIFICATION,
|
|
// IOCTL_MOUNTMGR_QUERY_DOS_VOLUME_PATH, and
|
|
// IOCTL_MOUNTMGR_QUERY_DOS_VOLUME_PATHS.
|
|
//
|
|
|
|
typedef struct _MOUNTMGR_TARGET_NAME {
|
|
USHORT DeviceNameLength;
|
|
WCHAR DeviceName[1];
|
|
} MOUNTMGR_TARGET_NAME, *PMOUNTMGR_TARGET_NAME;
|
|
|
|
//
|
|
// Macro that defines what a "drive letter" mount point is. This macro can
|
|
// be used to scan the result from QUERY_POINTS to discover which mount points
|
|
// are find "drive letter" mount points.
|
|
//
|
|
|
|
#define MOUNTMGR_IS_DRIVE_LETTER(s) ( \
|
|
(s)->Length == 28 && \
|
|
(s)->Buffer[0] == '\\' && \
|
|
(s)->Buffer[1] == 'D' && \
|
|
(s)->Buffer[2] == 'o' && \
|
|
(s)->Buffer[3] == 's' && \
|
|
(s)->Buffer[4] == 'D' && \
|
|
(s)->Buffer[5] == 'e' && \
|
|
(s)->Buffer[6] == 'v' && \
|
|
(s)->Buffer[7] == 'i' && \
|
|
(s)->Buffer[8] == 'c' && \
|
|
(s)->Buffer[9] == 'e' && \
|
|
(s)->Buffer[10] == 's' && \
|
|
(s)->Buffer[11] == '\\' && \
|
|
(s)->Buffer[12] >= 'A' && \
|
|
(s)->Buffer[12] <= 'Z' && \
|
|
(s)->Buffer[13] == ':')
|
|
|
|
//
|
|
// Macro that defines what a "volume name" mount point is. This macro can
|
|
// be used to scan the result from QUERY_POINTS to discover which mount points
|
|
// are "volume name" mount points.
|
|
//
|
|
|
|
#define MOUNTMGR_IS_VOLUME_NAME(s) ( \
|
|
((s)->Length == 96 || ((s)->Length == 98 && (s)->Buffer[48] == '\\')) && \
|
|
(s)->Buffer[0] == '\\' && \
|
|
((s)->Buffer[1] == '?' || (s)->Buffer[1] == '\\') && \
|
|
(s)->Buffer[2] == '?' && \
|
|
(s)->Buffer[3] == '\\' && \
|
|
(s)->Buffer[4] == 'V' && \
|
|
(s)->Buffer[5] == 'o' && \
|
|
(s)->Buffer[6] == 'l' && \
|
|
(s)->Buffer[7] == 'u' && \
|
|
(s)->Buffer[8] == 'm' && \
|
|
(s)->Buffer[9] == 'e' && \
|
|
(s)->Buffer[10] == '{' && \
|
|
(s)->Buffer[19] == '-' && \
|
|
(s)->Buffer[24] == '-' && \
|
|
(s)->Buffer[29] == '-' && \
|
|
(s)->Buffer[34] == '-' && \
|
|
(s)->Buffer[47] == '}' \
|
|
)
|
|
|
|
//
|
|
// The following IOCTL is supported by mounted devices.
|
|
//
|
|
|
|
#define IOCTL_MOUNTDEV_QUERY_DEVICE_NAME CTL_CODE(MOUNTDEVCONTROLTYPE, 2, METHOD_BUFFERED, FILE_ANY_ACCESS)
|
|
|
|
//
|
|
// Output structure for IOCTL_MOUNTDEV_QUERY_DEVICE_NAME.
|
|
//
|
|
|
|
typedef struct _MOUNTDEV_NAME {
|
|
USHORT NameLength;
|
|
WCHAR Name[1];
|
|
} MOUNTDEV_NAME, *PMOUNTDEV_NAME;
|
|
|
|
//
|
|
// Devices that wish to be mounted should report this GUID in
|
|
// IoRegisterDeviceInterface.
|
|
//
|
|
|
|
#ifdef DEFINE_GUID
|
|
|
|
DEFINE_GUID(MOUNTDEV_MOUNTED_DEVICE_GUID, 0x53f5630d, 0xb6bf, 0x11d0, 0x94, 0xf2, 0x00, 0xa0, 0xc9, 0x1e, 0xfb, 0x8b);
|
|
|
|
#endif
|
|
|
|
|
|
#endif // NTDDI_VERSION >= NTDDI_WIN2K
|
|
|
|
#if (NTDDI_VERSION >= NTDDI_WINXP)
|
|
|
|
#define IOCTL_MOUNTMGR_QUERY_DOS_VOLUME_PATH CTL_CODE(MOUNTMGRCONTROLTYPE, 12, METHOD_BUFFERED, FILE_ANY_ACCESS)
|
|
#define IOCTL_MOUNTMGR_QUERY_DOS_VOLUME_PATHS CTL_CODE(MOUNTMGRCONTROLTYPE, 13, METHOD_BUFFERED, FILE_ANY_ACCESS)
|
|
|
|
//
|
|
// Output structure for IOCTL_MOUNTMGR_QUERY_DOS_VOLUME_PATH and
|
|
// IOCTL_MOUNTMGR_QUERY_DOS_VOLUME_PATHS.
|
|
//
|
|
|
|
typedef struct _MOUNTMGR_VOLUME_PATHS {
|
|
ULONG MultiSzLength;
|
|
WCHAR MultiSz[1];
|
|
} MOUNTMGR_VOLUME_PATHS, *PMOUNTMGR_VOLUME_PATHS;
|
|
|
|
|
|
#define MOUNTMGR_IS_DOS_VOLUME_NAME(s) ( \
|
|
MOUNTMGR_IS_VOLUME_NAME(s) && \
|
|
(s)->Length == 96 && \
|
|
(s)->Buffer[1] == '\\' \
|
|
)
|
|
|
|
#define MOUNTMGR_IS_DOS_VOLUME_NAME_WB(s) ( \
|
|
MOUNTMGR_IS_VOLUME_NAME(s) && \
|
|
(s)->Length == 98 && \
|
|
(s)->Buffer[1] == '\\' \
|
|
)
|
|
|
|
#define MOUNTMGR_IS_NT_VOLUME_NAME(s) ( \
|
|
MOUNTMGR_IS_VOLUME_NAME(s) && \
|
|
(s)->Length == 96 && \
|
|
(s)->Buffer[1] == '?' \
|
|
)
|
|
|
|
#define MOUNTMGR_IS_NT_VOLUME_NAME_WB(s) ( \
|
|
MOUNTMGR_IS_VOLUME_NAME(s) && \
|
|
(s)->Length == 98 && \
|
|
(s)->Buffer[1] == '?' \
|
|
)
|
|
|
|
#endif // NTDDI_VERSION >= NTDDI_WINXP
|
|
|
|
#if (NTDDI_VERSION >= NTDDI_WS03)
|
|
|
|
#define IOCTL_MOUNTMGR_SCRUB_REGISTRY CTL_CODE(MOUNTMGRCONTROLTYPE, 14, METHOD_BUFFERED, FILE_READ_ACCESS | FILE_WRITE_ACCESS)
|
|
#define IOCTL_MOUNTMGR_QUERY_AUTO_MOUNT CTL_CODE(MOUNTMGRCONTROLTYPE, 15, METHOD_BUFFERED, FILE_ANY_ACCESS)
|
|
#define IOCTL_MOUNTMGR_SET_AUTO_MOUNT CTL_CODE(MOUNTMGRCONTROLTYPE, 16, METHOD_BUFFERED, FILE_READ_ACCESS | FILE_WRITE_ACCESS)
|
|
|
|
//
|
|
// Input / Output structure for querying / setting the auto-mount setting
|
|
//
|
|
|
|
typedef enum _MOUNTMGR_AUTO_MOUNT_STATE {
|
|
Disabled = 0,
|
|
Enabled
|
|
} MOUNTMGR_AUTO_MOUNT_STATE;
|
|
|
|
typedef struct _MOUNTMGR_QUERY_AUTO_MOUNT {
|
|
MOUNTMGR_AUTO_MOUNT_STATE CurrentState;
|
|
} MOUNTMGR_QUERY_AUTO_MOUNT, *PMOUNTMGR_QUERY_AUTO_MOUNT;
|
|
|
|
typedef struct _MOUNTMGR_SET_AUTO_MOUNT {
|
|
MOUNTMGR_AUTO_MOUNT_STATE NewState;
|
|
} MOUNTMGR_SET_AUTO_MOUNT, *PMOUNTMGR_SET_AUTO_MOUNT;
|
|
|
|
#endif // NTDDI_VERSION >= NTDDI_WS03
|
|
|
|
#if (NTDDI_VERSION >= NTDDI_WIN7)
|
|
|
|
#define IOCTL_MOUNTMGR_BOOT_DL_ASSIGNMENT CTL_CODE(MOUNTMGRCONTROLTYPE, 17, METHOD_BUFFERED, FILE_READ_ACCESS | FILE_WRITE_ACCESS)
|
|
#define IOCTL_MOUNTMGR_TRACELOG_CACHE CTL_CODE(MOUNTMGRCONTROLTYPE, 18, METHOD_BUFFERED, FILE_READ_ACCESS)
|
|
|
|
#endif // NTDDI_VERSION >= NTDDI_WIN7
|
|
|
|
#endif // _MOUNTMGR_
|
|
|