IVssExamineWriterMetadataEx::GetIdentityEx 메서드(vsbackup.h)
GetIdentityEx 메서드는 작성기 instance 이름 및 특정 작성기 instance 대한 기타 기본 정보를 가져옵니다.
구문
HRESULT GetIdentityEx(
[out] VSS_ID *pidInstance,
[out] VSS_ID *pidWriter,
[out] BSTR *pbstrWriterName,
[out] BSTR *pbstrInstanceName,
[out] VSS_USAGE_TYPE *pUsage,
[out] VSS_SOURCE_TYPE *pSource
);
매개 변수
[out] pidInstance
기록기 instance GUID(Globally Unique Identifier)입니다.
[out] pidWriter
기록기 클래스의 GUID입니다.
[out] pbstrWriterName
기록기의 이름을 지정하는 문자열에 대한 포인터입니다.
[out] pbstrInstanceName
기록기 instance 이름을 지정하는 문자열에 대한 포인터입니다.
[out] pUsage
기록기에서 관리하는 데이터가 호스트 시스템에서 사용되는 방식을 나타내는 VSS_USAGE_TYPE 열거형 값에 대한 포인터입니다.
[out] pSource
기록기에서 관리하는 데이터의 형식을 나타내는 VSS_SOURCE_TYPE 열거형 값에 대한 포인터입니다.
반환 값
다음은 이 메서드에 대한 유효한 반환 코드입니다.
| 값 | 의미 |
|---|---|
|
ID 정보를 반환했습니다. |
|
매개 변수 값 중 하나가 잘못되었습니다. |
|
호출자가 메모리가 부족하거나 다른 시스템 리소스가 부족합니다. |
|
XML 문서가 잘못되었습니다. 자세한 내용은 이벤트 로그를 확인합니다. 자세한 내용은 VSS에서 이벤트 및 오류 처리를 참조하세요. |
|
예기치 않은 오류입니다. 오류 코드가 오류 로그 파일에 기록됩니다. 자세한 내용은 VSS에서 이벤트 및 오류 처리를 참조하세요.
Windows Server 2008, Windows Vista, Windows Server 2003 및 Windows XP: 이 값은 Windows Server 2008 R2 및 Windows 7까지 지원되지 않습니다. E_UNEXPECTED 대신 사용됩니다. |
설명
이 메서드는 pbstrInstanceName 매개 변수를 제외하고 IVssExamineWriterMetadata::GetIdentity 메서드와 동일합니다.
pbstrInstanceName 매개 변수는 CVssWriter::Initialize에서 작성기를 초기화하는 동안 지정된 기록기 instance 이름입니다.
기록기 instance 이름은 단일 컴퓨터에서 동일한 기록기 클래스 ID를 사용하여 여러 기록기 인스턴스 실행을 지원하는 작성기에 유용합니다. 작성기 instance 이름을 사용하여 특정 instance 식별할 수 있습니다. 따라서 작성기는 작성기 클래스 내에서 instance 이름을 고유하게 만들어야 합니다. 또한 기록기 instance 이름은 백업과 복원 사이에 유지되어야 하며 VSS에서 다중 instance 기록기를 올바르게 복원하는 데 사용됩니다.
호출자는 SysFreeString을 호출하여 pbstrWriterName 및 pbstrInstanceName 매개 변수가 보유한 메모리를 해제해야 합니다.
IVssExamineWriterMetadataEx 인터페이스는 저장된 기록기 상태 정보(CreateVssExamineWriterMetadata 호출로 생성됨)에서 생성될 수 있습니다. 이 경우 다음이 true입니다.
- pidInstance 는 라이브 작성기 측면에서 아무 의미도 없을 수 있습니다.
- pidWriter가 라이브 기록기의 기록기 클래스와 일치하지 않는 경우 요청자는 해당 작성기의 구성 요소를 사용하면 안 됩니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows Vista [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2008, Windows Server 2003 SP1 [데스크톱 앱만 해당] |
| 대상 플랫폼 | Windows |
| 헤더 | vsbackup.h(VsBackup.h, Vss.h, VsWriter.h 포함) |
| 라이브러리 | VssApi.lib |