GetVirtualDiskMetadata-Funktion (virtdisk.h)

Ruft die angegebenen Metadaten vom virtuellen Datenträger ab.

Syntax

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

Parameter

[in] VirtualDiskHandle

Handle mit einem geöffneten virtuellen Datenträger.

[in] Item

Adresse einer GUID , die die abzurufenden Metadaten identifiziert.

[in, out] MetaDataSize

Adresse einer ULONG. Bei der Eingabe gibt der Wert die Größe des Puffers in Bytes an, auf den der MetaData-Parameter verweist. Bei der Ausgabe enthält der Wert die Größe der abgerufenen Metadaten in Bytes. Wenn der Puffer zu klein war, schlägt die API fehl und gibt ERROR_INSUFFICIENT_BUFFER zurück, wobei die erforderliche Größe in der ULONG festgelegt wird, und der Puffer enthält den Start der Metadaten.

[out] MetaData

Adresse des Puffers, in dem die Metadaten gespeichert werden sollen.

Rückgabewert

Status der Anforderung.

Wenn die Funktion erfolgreich ist, wird der Rückgabewert ERROR_SUCCESS.

Wenn der Puffer, auf den der Items-Parameter verweist, zu klein war, wird der Rückgabewert ERROR_INSUFFICIENT_BUFFER.

Wenn die Funktion fehlschlägt, ist der Rückgabewert ein Fehlercode. Weitere Informationen finden Sie unter Systemfehlercodes.

Anforderungen

Weitere Informationen

VHD-Funktionen