IVdsOpenVDisk::Attach 메서드(vds.h)

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

가상 디스크를 연결합니다.

구문

HRESULT Attach(
  [in]  LPWSTR                   pStringSecurityDescriptor,
  [in]  ATTACH_VIRTUAL_DISK_FLAG Flags,
  [in]  ULONG                    ProviderSpecificFlags,
  [in]  ULONG                    TimeoutInMs,
  [out] IVdsAsync                **ppAsync
);

매개 변수

[in] pStringSecurityDescriptor

가상 디스크에 대한 보안 설명자를 포함하는 문자열입니다. 지정하지 않으면 사용 중인 보안 설명자는 "D:P(A;; 조지아;;; Windows 7의 WD)" 및 "D:P(A;; 조지아;;; WD)(A;; 조지아;;; AC)" Windows 8.1 이상.

[in] Flags

가상 디스크를 연결할 방법을 지정하는 ATTACH_VIRTUAL_DISK_FLAG 열거형 값의 비트 마스크입니다. 가능한 값은 다음과 같습니다.

[in] ProviderSpecificFlags

연결된 가상 디스크 유형과 관련된 플래그의 비트 마스크입니다. 이러한 플래그는 공급자에 따라 다릅니다. Microsoft 가상 디스크 공급자의 경우 이 매개 변수는 0이어야 합니다.

[in] TimeoutInMs

이 매개 변수는 나중에 사용하도록 예약되어 있습니다.

[out] ppAsync

성공적으로 완료되면 IVdsAsync 인터페이스를 수신하여 이 작업을 모니터링하고 제어하는 IVdsAsync 인터페이스에 대한 포인터입니다. 호출자는 수신된 인터페이스를 완료했을 때 해제해야 합니다. 인터페이스에서 IVdsAsync::Wait 메서드가 호출되고 성공 HRESULT 값이 반환되는 경우 각 인터페이스 포인터에서 IUnknown::Release 메서드를 호출하여 VDS_ASYNC_OUTPUT 구조에 반환된 인터페이스를 해제해야 합니다. 그러나 Wait가 오류 HRESULT 값을 반환하거나 Wait의 pHrResult 매개 변수가 오류 HRESULT 값을 수신하는 경우 VDS_ASYNC_OUTPUT 구조의 인터페이스 포인터는 NULL이며 해제할 필요가 없습니다. Winerror.h에 정의된 SUCCEEDED 및 FAILED 매크로를 사용하여 성공 또는 실패 HRESULT 값을 테스트할 수 있습니다.

반환 값

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

설명

가상 디스크가 연결되면 호출자는 다음 알림 중 하나 또는 전부를 수신할 수 있습니다.

• 호출자가 VDS 알림에 등록되면 호출자는 디스크 도착 알림을 받습니다. 자세한 내용은 VDS 알림을 참조하세요.
• 호출자가 PnP 알림에 등록되면 호출자는 PnP 디스크 도착 알림을 받습니다. 자세한 내용은 RegisterDeviceNotification을 참조하세요.

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

요구 사항

추가 정보

IVdsOpenVDisk