Поделиться через


Функция GetStorageDependencyInformation (virtdisk.h)

Возвращает связи между виртуальными жесткими дисками (VHD), cd или DVD-файлом (ISO) или томами, содержащимися в этих дисках, и их родительским диском или томом.

Синтаксис

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
);

Параметры

[in] ObjectHandle

Дескриптор тома или корневого каталога, если параметр Flags не задает флаг GET_STORAGE_DEPENDENCY_FLAG_DISK_HANDLE . Сведения об открытии тома или корневого каталога см. в разделе Функция CreateFile .

Если параметр Flags указывает флаг GET_STORAGE_DEPENDENCY_FLAG_DISK_HANDLE , этот дескриптор должен быть дескриптором для диска.

[in] Flags

Допустимое сочетание GET_STORAGE_DEPENDENCY_FLAG значений.

[in] StorageDependencyInfoSize

Размер (в байтах) буфера, на который ссылается параметр StorageDependencyInfo .

[in, out] StorageDependencyInfo

Указатель на буфер для получения заполненной структуры STORAGE_DEPENDENCY_INFO , которая является структурой переменной длины.

[in, out, optional] SizeUsed

Необязательный указатель на ULONG , получающий используемый размер.

Возвращаемое значение

Состояние запроса.

Если функция выполняется успешно, возвращаемое значение будет ERROR_SUCCESS а параметр StorageDependencyInfo содержит запрошенные сведения о зависимости.

Если функция завершается сбоем, возвращаемое значение представляет собой код ошибки, а параметр StorageDependencyInfo не определен. Дополнительные сведения см. в разделе Системные коды ошибок.

Комментарии

Файлы образов КОМПАКТ-дисков и DVD-дисков (ISO) не поддерживаются до Windows 8 и Windows Server 2012.

Требования

Требование Значение
Минимальная версия клиента Windows 7
Минимальная версия сервера Windows Server 2008 R2
Целевая платформа Windows
Header virtdisk.h
Библиотека VirtDisk.lib
DLL VirtDisk.dll

См. также раздел

Сведения о виртуальном жестком диске

Справочник по VHD