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 포함) |
| 라이브러리 | VirtDisk.lib |
| DLL | VirtDisk.dll |