다음을 통해 공유

EnumerateVirtualDiskMetadata 함수(virtdisk.h)

  • 아티클

가상 디스크와 연결된 메타데이터를 열거합니다.

구문

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

매개 변수

[in] VirtualDiskHandle

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

[in, out] NumberOfItems

ULONG의 주소입니다. 입력에서 값은 Items 매개 변수가 가리키는 버퍼의 요소 수를 나타냅니다. 출력에서 값에는 검색된 항목 수가 포함됩니다. 버퍼가 너무 작으면 API가 실패하고 ERROR_INSUFFICIENT_BUFFER 반환하며 ULONG 에는 필요한 버퍼 크기가 포함됩니다.

[out] Items

메타데이터를 나타내는 GUID로 채울 버퍼의 주소입니다. GetVirtualDiskMetadata 함수를 사용하여 각 GUID가 나타내는 데이터를 검색할 수 있습니다.

반환 값

요청의 상태입니다.

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

Items 매개 변수가 가리키는 버퍼가 너무 작으면 반환 값이 ERROR_INSUFFICIENT_BUFFER.

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

요구 사항

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

추가 정보

VHD 함수