IVssComponent::GetNewTarget 메서드(vswriter.h)

GetNewTarget 메서드는 선택한 구성 요소 또는 구성 요소 집합에 대한 새 파일 복원 위치를 반환합니다. 구성 요소 선택에 대한 자세한 내용은 선택 가능성 및 논리 경로 작업을 참조하세요.

작성자 또는 요청자는 이 메서드를 호출할 수 있습니다.

구문

HRESULT GetNewTarget(
  [in]  UINT           iNewTarget,
  [out] IVssWMFiledesc **ppFiledesc
);

[in] iNewTarget

새 대상의 인덱스 번호입니다. 이 매개 변수의 값은 0에서 n-1 사이의 정수입니다. 여기서 n 은 지정된 구성 요소와 연결된 총 새 대상 수입니다. n 값은 IVssComponent::GetNewTargetCount에서 반환됩니다.

[out] ppFiledesc

새 대상 복원 위치 정보를 포함하는 IVssWMFiledesc 개체에 대한 이중 간접 포인터입니다.

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

값	의미
S_OK	특성 값을 반환했습니다.
E_INVALIDARG	매개 변수 값 중 하나가 잘못되었습니다.
E_OUTOFMEMORY	호출자가 메모리가 부족하거나 다른 시스템 리소스가 부족합니다.
VSS_E_INVALID_XML_DOCUMENT	XML 문서가 잘못되었습니다. 자세한 내용은 이벤트 로그를 확인합니다. 자세한 내용은 VSS에서 이벤트 및 오류 처리를 참조하세요.
VSS_E_OBJECT_NOT_FOUND	지정한 항목을 찾을 수 없습니다.

GetNewTarget에서 반환된 새 대상은 현재 구성 요소의 파일뿐만 아니라 선택 불가능한 하위 구성 요소의 파일에 대한 대상일 수 있습니다.