Compartir a través de


Función GetVirtualDiskMetadata (virtdisk.h)

Recupera los metadatos especificados del disco virtual.

Sintaxis

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

Parámetros

[in] VirtualDiskHandle

Identificador de un disco virtual abierto.

[in] Item

Dirección de un GUID que identifica los metadatos que se van a recuperar.

[in, out] MetaDataSize

Dirección de un ULONG. En la entrada, el valor indica el tamaño, en bytes, del búfer al que apunta el parámetro MetaData . En la salida, el valor contiene el tamaño, en bytes, de los metadatos recuperados. Si el búfer era demasiado pequeño, la API producirá un error y devolverá ERROR_INSUFFICIENT_BUFFER, colocando el tamaño necesario en ULONG y el búfer contendrá el inicio de los metadatos.

[out] MetaData

Dirección del búfer donde se almacenarán los metadatos.

Valor devuelto

Estado de la solicitud.

Si la función se ejecuta correctamente, el valor devuelto es ERROR_SUCCESS.

Si el búfer al que apunta el parámetro Items era demasiado pequeño, el valor devuelto es ERROR_INSUFFICIENT_BUFFER.

Si se produce un error en la función, el valor devuelto es un código de error. Para obtener más información, vea Códigos de error del sistema.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 8
Servidor mínimo compatible Windows Server 2012
Plataforma de destino Windows
Encabezado virtdisk.h (incluya Windows.h)
Library VirtDisk.lib
Archivo DLL VirtDisk.dll

Consulte también

Funciones de VHD