Share via

EnumerateVirtualDiskMetadata-Funktion (virtdisk.h)

  • Artikel

Listet die Metadaten auf, die einem virtuellen Datenträger zugeordnet sind.

Syntax

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

Parameter

[in] VirtualDiskHandle

Handle mit einem geöffneten virtuellen Datenträger.

[in, out] NumberOfItems

Adresse einer ULONG. Bei der Eingabe gibt der Wert die Anzahl der Elemente im Puffer an, auf die der Items-Parameter verweist. In der Ausgabe enthält der Wert die Anzahl der abgerufenen Elemente. Wenn der Puffer zu klein war, schlägt die API fehl und gibt ERROR_INSUFFICIENT_BUFFER zurück, und die ULONG enthält die erforderliche Puffergröße.

[out] Items

Adresse eines Puffers, der mit den GUIDsgefüllt werden soll, die die Metadaten darstellen. Die GetVirtualDiskMetadata-Funktion kann verwendet werden, um die von jeder GUID dargestellten Daten abzurufen.

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

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 8
Unterstützte Mindestversion (Server) Windows Server 2012
Zielplattform Windows
Kopfzeile virtdisk.h (einschließlich Windows.h)
Bibliothek VirtDisk.lib
DLL VirtDisk.dll

Weitere Informationen

VHD-Funktionen