Share via


IVssFileShareSnapshotProvider::Query 메서드(vsprov.h)

애플리케이션 서버에서 사용할 수 있는 모든 파일 공유 스냅샷에 대한 VSS_SNAPSHOT_PROP 구조체의 열거형을 가져옵니다.

구문

HRESULT Query(
  [in]  VSS_ID          QueriedObjectId,
  [in]  VSS_OBJECT_TYPE eQueriedObjectType,
  [in]  VSS_OBJECT_TYPE eReturnedObjectsType,
  [out] IVssEnumObject  **ppEnum
);

매개 변수

[in] QueriedObjectId

시스템에서 사용하도록 예약되었습니다. 이 매개 변수의 값은 GUID_NULL 합니다.

[in] eQueriedObjectType

시스템에서 사용하도록 예약되었습니다. 이 매개 변수의 값은 VSS_OBJECT_NONE 합니다.

[in] eReturnedObjectsType

시스템에서 사용하도록 예약되었습니다. 이 매개 변수의 값은 VSS_OBJECT_SNAPSHOT 합니다.

[out] ppEnum

반환 시 초기화되는 IVssEnumObject 인터페이스 포인터의 주소입니다. 호출자는 인터페이스를 해제해야 합니다. 이 매개 변수는 필수이며 null일 수 없습니다.

반환 값

다음은 이 메서드에 대한 유효한 반환 코드입니다.

의미
S_OK
쿼리 작업이 성공했습니다.
E_ACCESSDENIED
호출자에게 충분한 백업 권한이 없거나 관리자가 아닙니다.
E_INVALIDARG
매개 변수 값 중 하나가 잘못되었습니다.
E_OUTOFMEMORY
호출자가 메모리가 부족하거나 다른 시스템 리소스가 부족합니다.
VSS_E_PROVIDER_VETO
공급자 오류입니다. 공급자가 이벤트 로그에 오류를 기록했습니다. 자세한 내용은 VSS에서 이벤트 및 오류 처리를 참조하세요.

설명

이 메서드는 일반적으로 쿼리 작업을 스냅샷 생성된 요청자에 대한 응답으로 호출됩니다.

ppEnum 매개 변수를 통해 반환되는 IVssEnumObject 인터페이스에서 IVssEnumObject::Next 메서드를 호출하면 각 섀도 복사본에 대한 VSS_SNAPSHOT_PROP 구조체가 포함된 VSS_OBJECT_PROP 구조체가 반환됩니다.

요구 사항

   
지원되는 최소 클라이언트 Windows 8.1 [데스크톱 앱만 해당]
지원되는 최소 서버 Windows Server 2012 R2 [데스크톱 앱만 해당]
대상 플랫폼 Windows
헤더 vsprov.h
라이브러리 VssApi.lib

추가 정보

IVssFileShareSnapshotProvider