SetVirtualDiskMetadata 함수(virtdisk.h)

가상 디스크에 대한 메타데이터 항목을 설정합니다.

구문

DWORD SetVirtualDiskMetadata(
  [in] HANDLE     VirtualDiskHandle,
  [in] const GUID *Item,
  [in] ULONG      MetaDataSize,
  [in] const void *MetaData
);

매개 변수

[in] VirtualDiskHandle

열려 있는 가상 디스크에 대한 핸들입니다.

[in] Item

설정할 메타데이터를 식별하는 GUID 의 주소입니다. NULL GUID(모든 0의 GUID)가 될 수 없습니다.

[in] MetaDataSize

MetaData 매개 변수가 가리키는 버퍼의 크기(바이트)를 포함하는 ULONG의 주소입니다. 특정 VHD 파일 형식에는 메타데이터 요소당 최대 크기가 있습니다. 특정 VHD 파일에는 최대 총 메타데이터 항목 수와 총 메타데이터 크기도 있습니다.

[in] MetaData

저장할 메타데이터를 포함하는 버퍼의 주소입니다.

반환 값

요청의 상태입니다.

함수가 성공하면 반환 값이 ERROR_SUCCESS.

함수가 실패하면 반환 값은 오류 코드입니다. 자세한 내용은 시스템 오류 코드를 참조하세요.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 8
지원되는 최소 서버	Windows Server 2012
대상 플랫폼	Windows
헤더	virtdisk.h(Windows.h 포함)
라이브러리	VirtDisk.lib
DLL	VirtDisk.dll

추가 정보

VHD 함수