Share via

IVssHardwareSnapshotProvider::AreLunsSupported 메서드(vsprov.h)

  • 아티클

AreLunsSupported 메서드는 하드웨어 공급자가 볼륨에 기여하는 모든 LUN에 대해 섀도 복사본 생성을 지원하는지 여부를 결정합니다. VSS는 섀도 복사본 집합에 추가되는 각 볼륨에 대해 AreLunsSupported 메서드를 호출합니다. 이 메서드를 호출하기 전에 VSS는 볼륨에 기여하는 LUN을 결정합니다.

특정 볼륨의 경우 각 LUN은 한 번만 기여할 수 있습니다. 특정 LUN은 여러 볼륨에 기여할 수 있습니다.

참고 하드웨어 공급자는 Windows Server 운영 체제에서만 지원됩니다.
 

구문

HRESULT AreLunsSupported(
  [in]      LONG                lLunCount,
  [in]      LONG                lContext,
  [in]      VSS_PWSZ            *rgwszDevices,
  [in, out] VDS_LUN_INFORMATION *pLunInformation,
  [out]     BOOL                *pbIsSupported
);

매개 변수

[in] lLunCount

이 섀도 복사본 볼륨에 기여하는 LUN 수입니다.

[in] lContext

_VSS_VOLUME_SNAPSHOT_ATTRIBUTES 열거형의 플래그 비트 마스크로 열거된 현재 섀도 복사본 집합에 대한 섀도 복사본 컨텍스트입니다. VSS_VOLSNAP_ATTR_TRANSPORTABLE 플래그가 설정되면 섀도 복사본 집합을 전송할 수 있습니다.

[in] rgwszDevices

섀도 복사할 LUN에 해당하는 디바이스 목록입니다.

[in, out] pLunInformation

이 섀도 복사본 볼륨에 기여하는 각 LUN에 대해 하나씩 lLunCountVDS_LUN_INFORMATION 구조체의 배열입니다.

[out] pbIsSupported

BOOL 값에 대한 포인터입니다. 모든 디바이스가 섀도 복사본에 지원되는 경우 공급자는 pbIsSupported가 가리키는 위치에 TRUE 값을 저장해야 합니다.

반환 값

이 메서드는 이러한 값 중 하나를 반환할 수 있습니다.

반환 코드/값 설명
S_OK
0x00000000L
 작업이 성공적으로 완료되었습니다.
E_OUTOFMEMORY
0x8007000EL
 메모리 부족 또는 기타 시스템 리소스.
E_INVALIDARG
0x80070057L
 매개 변수 값 중 하나가 잘못되었습니다.
VSS_E_PROVIDER_VETO
0x80042306L
 예기치 않은 공급자 오류가 발생했습니다. 공급자는 사용자에게 문제를 resolve 방법에 대한 정보를 제공하는 이벤트를 애플리케이션 이벤트 로그에 보고해야 합니다.

설명

하드웨어 하위 시스템이 SCSI 조회 데이터 및 중요 제품 데이터 페이지 80(디바이스 일련 번호) 및 페이지 83(디바이스 ID) 지침을 지원하는 경우 공급자 는 pLunInformation 배열의 구조를 수정할 필요가 없습니다.

어쨌든 AreLunsSupported 메서드는 pLunInformation 배열에 있는 VDS_LUN_INFORMATION 구조체의 m_rgInterconnects 멤버 값을 수정해서는 안 됩니다.

공급자가 pLunInformation 배열의 모든 LUN에 대해 하드웨어 섀도 복사본 만들기를 지원하는 경우 pbIsSupported 매개 변수가 가리키는 BOOL 값에 TRUE를 반환해야 합니다. 공급자가 하나 이상의 LUN에 대한 하드웨어 섀도 복사본을 지원하지 않는 경우 이 BOOL 값을 FALSE로 설정해야 합니다.

공급자는 문제가 일시적이더라도 섀도 복사본을 만들 수 없는 경우 섀도 복사본을 만드는 데 동의해서는 안 됩니다. 낮은 리소스와 같은 일시적인 조건으로 인해 AreLunsSupported 가 호출될 때 공급자가 하나 이상의 LUN을 사용하여 섀도 복사본을 만들 수 없는 경우 공급자는 BOOL 값을 FALSE로 설정해야 합니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 지원되는 버전 없음
지원되는 최소 서버 Windows Server 2003 [데스크톱 앱만 해당]
대상 플랫폼 Windows
헤더 vsprov.h

추가 정보

IVssHardwareSnapshotProvider

VDS_LUN_INFORMATION

_VSS_VOLUME_SNAPSHOT_ATTRIBUTES