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

Статья
03/03/2024

Извлекает указанные метаданные с виртуального диска.

Синтаксис

DWORD GetVirtualDiskMetadata(
  [in]      HANDLE     VirtualDiskHandle,
  [in]      const GUID *Item,
  [in, out] PULONG     MetaDataSize,
  [out]     PVOID      MetaData
);

Параметры

[in] VirtualDiskHandle

Дескриптор открытого виртуального диска.

[in] Item

Адрес GUID , определяющий извлекаемую метаданные.

[in, out] MetaDataSize

Адрес ULONG. На входных данных значение указывает размер (в байтах) буфера, на который указывает параметр MetaData . В выходных данных значение содержит размер извлеченных метаданных в байтах. Если буфер был слишком мал, API завершится ошибкой и возвратит ERROR_INSUFFICIENT_BUFFER, поместив необходимый размер в ULONG , и буфер будет содержать начало метаданных.

[out] MetaData

Адрес буфера, в котором должны храниться метаданные.

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

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

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

Если буфер, на который указывает параметр Items, был слишком мал, возвращаемое значение будет ERROR_INSUFFICIENT_BUFFER.

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

Требования

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

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

Функции VHD

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