IVdsVDisk::Open 메서드(vds.h)

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

지정된 가상 디스크 파일에 대한 핸들을 열고 열린 핸들을 나타내는 개체에 대한 IVdsOpenVDisk 인터페이스 포인터를 반환합니다.

구문

HRESULT Open(
  [in]  VIRTUAL_DISK_ACCESS_MASK AccessMask,
  [in]  OPEN_VIRTUAL_DISK_FLAG   Flags,
  [in]  ULONG                    ReadWriteDepth,
  [out] IVdsOpenVDisk            **ppOpenVDisk
);

매개 변수

[in] AccessMask

열린 가상 디스크에 적용할 액세스 권한을 지정하는 VIRTUAL_DISK_ACCESS_MASK 플래그의 비트 마스크입니다.

[in] Flags

가상 디스크를 여는 방법을 지정하는 OPEN_VIRTUAL_DISK_FLAG 플래그의 비트 마스크입니다.

[in] ReadWriteDepth

읽기/쓰기를 여는 백업 저장소 체인의 자식부터 시작하는 저장소(백업 파일)의 수입니다. 차이점 체인의 나머지 저장소는 읽기 전용으로 열립니다. 병합 작업이 성공하려면 이 작업이 필요합니다.

[out] ppOpenVDisk

가상 디스크 개체에 대해 열린 핸들을 나타내는 새로 만든 개체에 대한 IVdsOpenVDisk 인터페이스 포인터를 수신하는 변수에 대한 포인터입니다. 호출자는 IUnknown::Release 메서드를 호출하여 더 이상 필요하지 않은 경우 인터페이스 포인터를 해제해야 합니다.

반환 값

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

반환 코드	Description
S_OK	메서드가 완료되었습니다.

설명

애플리케이션은 CoInitializeSecurity 함수를 호출하여 프로세스 전체 보안을 초기화해야 합니다. dwImpLevel 매개 변수는 RPC_C_IMP_LEVEL_IMPERSONATE 설정해야 합니다.

Windows Server 2008, Windows Vista 및 Windows Server 2003: 이러한 작업은 Windows 7 및 Windows Server 2008 R2까지 필요하지 않습니다.

요구 사항

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

추가 정보

IVdsVDisk