IVdsProviderPrivate::OnUnload 메서드(vdshwprv.h)

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

공급자 개체에 자신을 초기화하지 말라는 메시지를 표시합니다.

구문

HRESULT OnUnload(
  [in] BOOL bForceUnload
);

[in] bForceUnload

true이면 VDS가 공급자를 강제로 언로드하려고 시도합니다. false이면 VDS는 이러한 시도를 하지 않습니다.

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

반환 코드	Description
S_OK	공급자가 언로드됩니다.
S_FALSE	공급자는 현재 언로드할 수 없습니다. VDS는 나중에 다시 시도합니다.

VDS는 공급자 개체에 대한 참조를 해제하기 직전에 이 메서드를 호출합니다. 참조 수가 0으로 떨어지면 공급자가 언로드됩니다. OnLoad 메서드가 실패하면 VDS는 OnUnload를 호출하지 않습니다.

구현자에 대한 참고 사항: OnUnload를 호출하지 않고도 필요한 모든 클린 수행해야 합니다.