GetVirtualDiskMetadata 関数 (virtdisk.h)

指定したメタデータを仮想ディスクから取得します。

構文

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

パラメーター

[in] VirtualDiskHandle

開いている仮想ディスクを処理します。

[in] Item

取得するメタデータを識別する GUID のアドレス。

[in, out] MetaDataSize

ULONG のアドレス。 入力時の値は、 MetaData パラメーターによって指されるバッファーのサイズ (バイト単位) を示します。 出力では、値には取得されたメタデータのサイズ (バイト単位) が含まれます。 バッファーが小さすぎると、API は失敗し 、ERROR_INSUFFICIENT_BUFFERを返し、必要なサイズを ULONG に格納すると、バッファーにはメタデータの先頭が含まれます。

[out] MetaData

メタデータが格納されるバッファーのアドレス。

戻り値

要求の状態。

関数が成功した場合、戻り値は ERROR_SUCCESS。

Items パラメーターが指すバッファーが小さすぎる場合、戻り値はERROR_INSUFFICIENT_BUFFER。

関数が失敗した場合、戻り値はエラー コードです。 詳細については、「 システム エラー コード」を参照してください。

要件

要件	値
サポートされている最小のクライアント	Windows 8
サポートされている最小のサーバー	Windows Server 2012
対象プラットフォーム	Windows
ヘッダー	virtdisk.h (Windows.h を含む)
Library	VirtDisk.lib
[DLL]	VirtDisk.dll

こちらもご覧ください

VHD 関数