IVssWMDependency::GetComponentName 메서드(vswriter.h)

GetComponentName 메서드는 명시적 기록기-구성 요소 종속성에서 현재 구성 요소가 의존하는 구성 요소의 이름을 검색합니다.

구문

HRESULT GetComponentName(
  BSTR *pbstrComponentName
);

pbstrComponentName

현재 구성 요소가 종속된 구성 요소의 이름을 포함하는 NULL로 끝나는 와이드 문자열을 수신하는 호출자 할당 변수의 주소입니다.

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

값	의미
S_OK	현재 구성 요소가 의존하는 구성 요소의 이름을 반환했습니다.
S_FALSE	현재 구성 요소가 의존하는 구성 요소를 관리하는 작성기를 찾을 수 없습니다.
E_INVALIDARG	포인터 pbstrComponentName은 할당되지 않은 메모리를 가리킵니다.
E_OUTOFMEMORY	호출자가 메모리가 부족하거나 다른 시스템 리소스가 부족합니다.
VSS_E_INVALID_XML_DOCUMENT	XML 문서가 잘못되었습니다. 자세한 내용은 이벤트 로그를 확인합니다. 자세한 내용은 VSS에서 이벤트 및 오류 처리를 참조하세요.
VSS_E_UNEXPECTED	예기치 않은 오류입니다. 오류 코드가 오류 로그 파일에 기록됩니다. 자세한 내용은 VSS에서 이벤트 및 오류 처리를 참조하세요. Windows Server 2008, Windows Vista, Windows Server 2003 및 Windows XP: 이 값은 Windows Server 2008 R2 및 Windows 7까지 지원되지 않습니다. E_UNEXPECTED 대신 사용됩니다.

호출자는 SysFreeString을 호출하여 반환된 문자열에서 사용하는 메모리를 해제해야 합니다.

종속성은 문서화된 종속성이 있는 구성 요소와 종속된 구성 요소 간의 기본 설정 순서를 나타내지 않습니다. 종속성은 구성 요소와 종속된 구성 요소가 항상 함께 백업되거나 복원되어야 함을 나타냅니다.

지정된 작성기 클래스의 여러 인스턴스가 있을 수 있습니다. 그러나 구성 요소의 논리적 경로와 이름은 고유해야 합니다.

기록기 클래스의 여러 인스턴스가 있는 경우 논리 경로 및 구성 요소 이름 정보를 사용하여 현재 구성 요소가 의존하는 구성 요소를 관리하는 instance 식별해야 합니다.