다음을 통해 공유


IVdsPack::AddDisk 메서드(vds.h)

[Windows 8 및 Windows Server 2012 가상 디스크 서비스 COM 인터페이스는 Windows Storage 관리 API로 대체됩니다.]

온라인 팩에 디스크를 추가합니다.

구문

HRESULT AddDisk(
  [in] VDS_OBJECT_ID       DiskId,
  [in] VDS_PARTITION_STYLE PartitionStyle,
  [in] BOOL                bAsHotSpare
);

매개 변수

[in] DiskId

디스크의 GUID입니다.

[in] PartitionStyle

스타일은 MBR 또는 GPT일 수 있습니다. VDS_PARTITION_STYLE 열거형을 참조하세요.

[in] bAsHotSpare

true인 경우 VDS는 디스크를 핫 스페어로 사용할 수 있습니다. 그렇지 않으면 이 작업에 디스크를 사용할 수 없습니다. 하드웨어 공급자만 핫 스파링을 지원합니다.

반환 값

이 메서드는 표준 HRESULT 값(예: E_INVALIDARG 또는 E_OUTOFMEMORY) 및 VDS 관련 반환 값을 반환할 수 있습니다. 또한 HRESULT_FROM_WIN32 매크로를 사용하여 변환된 시스템 오류 코드를 반환할 수도 있습니다. 오류는 VDS 자체 또는 사용 중인 기본 VDS 공급자 에서 발생할 수 있습니다. 가능한 반환 값은 다음과 같습니다.

반환 코드/값 Description
S_OK
디스크가 성공적으로 추가되었습니다.
VDS_E_NOT_AN_UNALLOCATED_DISK
0x80042418L
디스크가 원시입니다.
VDS_E_OPERATION_DENIED
0x8004240AL
추가할 디스크가 정리되고 있습니다.
VDS_E_PROVIDER_FAILURE
0x80042442L
작업 중에 공급자 오류가 발생했습니다.
VDS_E_NOT_SUPPORTED
0x80042400L
기본 팩에 두 번째 디스크를 추가하는 것은 지원되지 않습니다.
VDS_E_PACK_OFFLINE
0x80042444L
대상 팩에 액세스할 수 없습니다.
VDS_E_OBJECT_NOT_FOUND
0x80042405L
디스크를 찾을 수 없습니다.
VDS_E_DMADMIN_METHOD_CALL_FAILED
0x80042420L
LDM(논리 디스크 관리자) 서비스가 메서드를 완료하지 못했습니다.
VDS_E_PROVIDER_CACHE_CORRUPT
0x8004241FL
동적 공급자 캐시가 손상되었습니다.

설명

VDS는 이 메서드를 구현합니다.

이 메서드는 원시 디스크(분할이 정의되지 않은 디스크)를 초기화하고 팩에 추가합니다. 이 메서드를 호출하기 전에 원시 디스크는 VDS 서비스에서 소유합니다. 이 메서드가 반환되면 디스크는 기본 공급자가 소유합니다.

분할 형식을 제거하고 디스크를 VDS 서비스가 소유한 원시 디스크로 만들려면 이 메서드의 효과를 실행 취소하려면 IVdsAdvancedDisk::Clean 메서드를 사용합니다.

AddDisk를 사용하여 기존 디스크에서 분할을 다시 정의할 수 없습니다.

기본 팩에 GPT 디스크를 추가하는 경우 작업은 디스크에 MSR 파티션을 자동으로 만듭니다. 관리자가 디스크에 ESP 파티션을 만드는 것을 선호할 수 있으므로 WinPE 운영 체제를 실행하는 디바이스는 예외입니다. ESP 파티션이 있는 경우 디스크의 첫 번째 파티션이어야 합니다.

동적 팩에 디스크를 추가하는 경우 작업에서 MSR 파티션을 만들지 않습니다.

요구 사항

요구 사항
지원되는 최소 클라이언트 Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버 Windows Server 2003 [데스크톱 앱만 해당]
대상 플랫폼 Windows
헤더 vds.h
라이브러리 Uuid.lib

추가 정보

IVdsPack

VDS_PACK_PROP

VDS_PARTITION_STYLE