MOUNTMGR_MOUNT_POINT structure

The MOUNTMGR_MOUNT_POINT structure is used by mount manager clients in conjunction with an IOCTL_MOUNTMGR_QUERY_POINTS request to query the mount manager for all of the mount points (symbolic links) associated with a device. The mount manager responds by sending an array of MOUNTMGR_MOUNT_POINT structures containing the mount points.

Syntax

typedef struct _MOUNTMGR_MOUNT_POINT {
  ULONG  SymbolicLinkNameOffset;
  USHORT SymbolicLinkNameLength;
  ULONG  UniqueIdOffset;
  USHORT UniqueIdLength;
  ULONG  DeviceNameOffset;
  USHORT DeviceNameLength;
} MOUNTMGR_MOUNT_POINT, *PMOUNTMGR_MOUNT_POINT;

Members

SymbolicLinkNameOffset

Contains an offset, in bytes, into the output buffer where the symbolic link is located.

SymbolicLinkNameLength

Contains the length, in bytes, of the symbolic link.

UniqueIdOffset

Contains an offset, in bytes, into the output buffer where the unique ID is located.

UniqueIdLength

Contains the length, in bytes, of the unique ID.

DeviceNameOffset

Contains an offset, in bytes, into the output buffer where the nonpersistent device name is located.

DeviceNameLength

Contains the length, in bytes, of the nonpersistent device name.

Remarks

None of the names returned are NULL terminated, nor do the buffers require terminating NULL characters. The caller of IOCTL_MOUNTMGR_QUERY_POINTS is not required to provide data in all of the members of the MOUNTMGR_MOUNT_POINT structure, but empty members must have an offset of zero.

On input, offsets are from the beginning of the MOUNTMGR_MOUNT_POINT structure. On output offsets are from the beginning of the buffer. This is usually the same as the beginning of the MOUNTMGR_MOUNT_POINTS container structure (as opposed to the embedded MOUNTMGR_MOUNT_POINT array instance).

The IOCTL_MOUNTMGR_QUERY_POINTS request is available in Windows 2000 and later operating systems.

For a discussion of the different between symbolic links, unique IDs, and nonpersistent device names, see Supporting Mount Manager Requests in a Storage Class Driver.

Requirements

See also

IOCTL_MOUNTMGR_QUERY_POINTS

Send comments about this topic to Microsoft