Condividi tramite


Funzione GetVirtualDiskMetadata (virtdisk.h)

Recupera i metadati specificati dal disco virtuale.

Sintassi

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

Parametri

[in] VirtualDiskHandle

Gestire in un disco virtuale aperto.

[in] Item

Indirizzo di un GUID che identifica i metadati da recuperare.

[in, out] MetaDataSize

Indirizzo di un ULONG. In input, il valore indica le dimensioni, in byte, del buffer a cui punta il parametro MetaData . Nell'output il valore contiene dimensioni, in byte, dei metadati recuperati. Se il buffer era troppo piccolo, l'API avrà esito negativo e restituirà ERROR_INSUFFICIENT_BUFFER, inserendo le dimensioni necessarie in ULONG e il buffer conterrà l'inizio dei metadati.

[out] MetaData

Indirizzo del buffer in cui archiviare i metadati.

Valore restituito

Stato della richiesta.

Se la funzione ha esito positivo, il valore restituito è ERROR_SUCCESS.

Se il buffer puntato dal parametro Items è troppo piccolo, il valore restituito è ERROR_INSUFFICIENT_BUFFER.

Se la funzione ha esito negativo, il valore restituito è un codice di errore. Per altre informazioni, vedere Codici di errore di sistema.

Requisiti

Requisito Valore
Client minimo supportato Windows 8
Server minimo supportato Windows Server 2012
Piattaforma di destinazione Windows
Intestazione virtdisk.h (include Windows.h)
Libreria VirtDisk.lib
DLL VirtDisk.dll

Vedi anche

Funzioni VHD