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

Статья
03/03/2024

Перечисляет метаданные, связанные с виртуальным диском.

Синтаксис

DWORD EnumerateVirtualDiskMetadata(
  [in]      HANDLE VirtualDiskHandle,
  [in, out] PULONG NumberOfItems,
  [out]     GUID   *Items
);

Параметры

[in] VirtualDiskHandle

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

[in, out] NumberOfItems

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

[out] Items

Адрес буфера, заполняемого идентификаторами GUID, представляющими метаданные. Функцию GetVirtualDiskMetadata можно использовать для получения данных, представленных каждым ИДЕНТИФИКАТОРом GUID.

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

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

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

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

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

Требования

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

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

Функции VHD

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