GetStorageDependencyInformation function (virtdisk.h)

Article
02/22/2024

Returns the relationships between virtual hard disks (VHDs) or CD or DVD image file (ISO) or the volumes contained within those disks and their parent disk or volume.

Syntax

DWORD GetStorageDependencyInformation(
  [in]                HANDLE                      ObjectHandle,
  [in]                GET_STORAGE_DEPENDENCY_FLAG Flags,
  [in]                ULONG                       StorageDependencyInfoSize,
  [in, out]           PSTORAGE_DEPENDENCY_INFO    StorageDependencyInfo,
  [in, out, optional] PULONG                      SizeUsed
);

Parameters

[in] ObjectHandle

A handle to a volume or root directory if the Flags parameter does not specify the GET_STORAGE_DEPENDENCY_FLAG_DISK_HANDLE flag. For information on how to open a volume or root directory, see the CreateFile function.

If the Flags parameter specifies the GET_STORAGE_DEPENDENCY_FLAG_DISK_HANDLE flag, this handle should be a handle to a disk.

[in] Flags

A valid combination of GET_STORAGE_DEPENDENCY_FLAG values.

[in] StorageDependencyInfoSize

Size, in bytes, of the buffer that the StorageDependencyInfo parameter refers to.

[in, out] StorageDependencyInfo

A pointer to a buffer to receive the populated STORAGE_DEPENDENCY_INFO structure, which is a variable-length structure.

[in, out, optional] SizeUsed

An optional pointer to a ULONG that receives the size used.

Return value

Status of the request.

If the function succeeds, the return value is ERROR_SUCCESS and the StorageDependencyInfo parameter contains the requested dependency information.

If the function fails, the return value is an error code and the StorageDependencyInfo parameter is undefined. For more information, see System Error Codes.

Remarks

CD and DVD image files (ISO) are not supported before Windows 8 and Windows Server 2012.

Requirements

Requirement	Value
Minimum supported client	Windows 7
Minimum supported server	Windows Server 2008 R2
Target Platform	Windows
Header	virtdisk.h
Library	VirtDisk.lib
DLL	VirtDisk.dll