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.

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

요구 사항

추가 정보

VHD 함수