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

아티클
03/06/2024

LocateLuns 메서드는 컴퓨터에 섀도 복사본 LUN을 표시하도록 하드웨어 공급자에게 프롬프트를 표시합니다. 하드웨어 섀도 복사본 집합을 컴퓨터로 가져올 때 LocateLuns 메서드는 VSS에서 호출됩니다. 공급자는 하드웨어 수준에서 마스킹 해제(또는 "표면화")를 담당합니다.

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

구문

HRESULT LocateLuns(
  [in] LONG                lLunCount,
  [in] VDS_LUN_INFORMATION *rgSourceLuns
);

매개 변수

[in] lLunCount

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

[in] rgSourceLuns

가져올 섀도 복사본 집합의 일부인 각 LUN에 대해 하나씩 iLunCountVDS_LUN_INFORMATION 구조체의 배열에 대한 포인터입니다.

반환 값

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

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

설명

rgSourceLuns 매개 변수에서 VSS는 공급자가 IVssHardwareSnapshotProvider::GetTargetLuns 메서드에서 이전에 초기화한 것과 동일한 VDS_LUN_INFORMATION 구조 배열을 제공합니다. 배열의 각 VDS_LUN_INFORMATION 구조에 대해 공급자는 해당 섀도 복사본 LUN을 컴퓨터에 마스크(또는 "surface")해야 합니다.

이 메서드가 반환된 직후 VSS는 다시 검사 및 열거를 수행하여 도착한 디바이스를 검색합니다. 이로 인해 노출된 LUN이 PnP 관리자에 의해 검색됩니다. VSS는 디스크 도착 수신 대기와 동시에 숨겨진 볼륨 도착을 수신 대기합니다. VSS는 섀도 복사본 집합에 기여하는 모든 볼륨이 시스템에 표시되거나 시간 초과가 발생한 후 수신 대기를 중지합니다. 일부 디스크 또는 볼륨 디바이스가 이 창에 나타나지 않으면 요청자에게 요청자에게 VSS_S_SOME_SNAPSHOTS_NOT_IMPORTED 반환하는 VSS에서 일부 섀도 복사본만 가져온 것으로 표시됩니다. GetTargetLuns 및 IVssHardwareSnapshotProvider::FillInLunInfo 메서드에서 받은 VDS_LUN_INFORMATION 구조가 일치하지 않는 경우에도 요청자는 VSS에서 동일한 오류를 수신합니다.

이 메서드는 섀도 복사본 LUN을 읽기 전용으로 매핑하는 데 사용할 수 없습니다.

요구 사항

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