IVssBackupComponents::D isableWriterInstances 메서드(vsbackup.h)

DisableWriterInstances 메서드는 지정된 기록기 instance 또는 인스턴스를 사용하지 않도록 설정합니다.

구문

HRESULT DisableWriterInstances(
  [in] const VSS_ID *rgWriterInstanceId,
  [in] UINT         cInstanceId
);

매개 변수

[in] rgWriterInstanceId

하나 이상의 기록기 instance 식별자를 포함하는 배열입니다.

[in] cInstanceId

rgWriterInstanceId 배열의 항목 수입니다.

반환 값

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

의미
S_OK
기록기 클래스가 성공적으로 사용하도록 설정되었습니다.
E_ACCESSDENIED
호출자에게 충분한 백업 권한이 없거나 관리자가 아닙니다.
E_OUTOFMEMORY
호출자가 메모리가 부족하거나 다른 시스템 리소스가 부족합니다.
VSS_E_BAD_STATE
백업 구성 요소 개체가 초기화되지 않았거나, 복원 작업 중에 이 메서드가 호출되었거나, 이 메서드가 올바른 시퀀스 내에서 호출되지 않았습니다.
VSS_E_UNEXPECTED
예기치 않은 오류입니다. 오류 코드가 오류 로그 파일에 기록됩니다. 자세한 내용은 VSS에서 이벤트 및 오류 처리를 참조하세요.

Windows Server 2008, Windows Vista, Windows Server 2003 및 Windows XP: 이 값은 Windows Server 2008 R2 및 Windows 7까지 지원되지 않습니다. E_UNEXPECTED 대신 사용됩니다.

설명

동일한 작성기의 여러 실행 복사본이 있는 경우 모두 동일한 기록기 클래스 식별자를 갖지만 다른 기록기 instance 식별자가 있습니다. 기록기의 한 instance 사용하지 않도록 설정해도 기록기의 다른 인스턴스가 비활성화되지는 않습니다.

DisableWriterInstances를 호출하는 경우 IVssBackupComponents::GatherWriterMetadata 메서드를 호출하기 전에 호출해야 합니다. GatherWriterMetadata를 먼저 호출한 다음 DisableWriterInstances를 호출하는 경우 DisableWriterInstances에 대한 호출은 적용되지 않습니다. GatherWriterMetadata를 먼저 호출해야 하는 경우 사용하지 않도록 설정할 기록기 인스턴스를 결정하려면 IVssBackupComponents 인터페이스의 다른 instance 호출해야 합니다.

요구 사항

요구 사항
지원되는 최소 클라이언트 Windows XP [데스크톱 앱만 해당]
지원되는 최소 서버 Windows Server 2003 [데스크톱 앱만 해당]
대상 플랫폼 Windows
헤더 vsbackup.h(VsBackup.h, Vss.h, VsWriter.h 포함)
라이브러리 VssApi.lib

추가 정보

IVssBackupComponents

IVssBackupComponents::D isableWriterClasses

IVssBackupComponents::EnableWriterClasses

IVssBackupComponents::GatherWriterMetadata