EN
이 콘텐츠는 한국어로 제공되지 않아 영어 버전으로 표시됩니다.

GetVirtualDiskMetadata function

Retrieves the specified metadata from the virtual disk.

Syntax


DWORD WINAPI GetVirtualDiskMetadata(
  _In_     HANDLE VirtualDiskHandle,
  _In_     LPGUID Item,
  _Inout_  PULONG MetaDataSize,
  _Out_    PVOID MetaData
);

Parameters

VirtualDiskHandle [in]

Handle to an open virtual disk.

Item [in]

Address of a GUID identifying the metadata to retrieve.

MetaDataSize [in, out]

Address of a ULONG. On input, the value indicates the size, in bytes, of the buffer pointed to by the MetaData parameter. On output, the value contains size, in bytes, of the retrieved metadata. If the buffer was too small, the API will fail and return ERROR_INSUFFICIENT_BUFFER, putting the required size in the ULONG and the buffer will contain the start of the metadata.

MetaData [out]

Address of the buffer where the metadata is to be stored.

Return value

Status of the request.

If the function succeeds, the return value is ERROR_SUCCESS.

If the buffer pointed to by the Items parameter was too small, the return value is ERROR_INSUFFICIENT_BUFFER.

If the function fails, the return value is an error code. For more information, see System Error Codes.

Requirements

Minimum supported client

Windows 8

Minimum supported server

Windows Server 2012

Header

VirtDisk.h (include Windows.h)

Library

VirtDisk.lib

DLL

VirtDisk.dll

See also

VHD Functions

 

 

Send comments about this topic to Microsoft

Build date: 10/26/2012

커뮤니티 추가 항목

추가
표시:
© 2014 Microsoft