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

DisableWriterClasses 메서드는 특정 작성기 클래스가 이벤트를 수신하지 못하도록 합니다.

구문

HRESULT DisableWriterClasses(
  [in] const VSS_ID *rgWriterClassId,
  [in] UINT         cClassId
);

매개 변수

[in] rgWriterClassId

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

[in] cClassId

rgWriterClassId 배열의 항목 수입니다.

반환 값

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

값	의미
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 식별자가 있습니다. 기록기 클래스를 사용하지 않도록 설정하면 모든 기록기의 인스턴스가 비활성화됩니다.

DisableWriterClasses 메서드와 IVssBackupComponents::EnableWriterClasses 메서드가 호출되지 않으면 모든 작성기 클래스가 사용하도록 설정됩니다.

DisableWriterClasses에 대한 첫 번째 호출이 반환되면 rgWriterClassId 배열에 지정된 작성기 클래스가 비활성화되고 다른 모든 작성기 클래스가 사용하도록 설정됩니다.

DisableWriterClasses를 두 번 이상 호출하는 경우 각 호출은 rgWriterClassId 배열의 작성기를 비활성화된 작성기 목록에 추가합니다.

DisableWriterClasses를 한 번 이상 호출한 다음 EnableWriterClasses를 호출하는 경우 EnableWriterClasses에 대한 첫 번째 호출은 DisableWriterClasses 호출의 효과를 취소하고 rgWriterClassId 배열의 작성기만 사용하도록 설정합니다.

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

요구 사항

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

추가 정보

IVssBackupComponents

IVssBackupComponents::D isableWriterInstances

IVssBackupComponents::EnableWriterClasses