다음을 통해 공유


IOpcPartSet::GetPart 메서드(msopc.h)

집합에서 지정된 부분을 나타내는 파트 개체를 가져옵니다.

구문

HRESULT GetPart(
  [in]          IOpcPartUri *name,
  [out, retval] IOpcPart    **part
);

매개 변수

[in] name

파트의 파트 이름을 나타내는 파트 URI 개체의 IOpcPartUri 인터페이스에 대한 포인터입니다.

[out, retval] part

지정된 부품 이름을 가진 파트를 나타내는 파트 개체의 IOpcPart 에 대한 포인터입니다.

반환 값

이 메서드는 HRESULT를 반환합니다. 가능한 값에는 다음 표에 있는 값이 포함되지만, 이에 국한되는 것은 아닙니다.

반환 코드/값 Description
S_OK
메서드가 성공했습니다.
E_POINTER
이름 매개 변수는 NULL입니다.
OPC_E_NO_SUCH_PART
0x80510018
지정된 부분이 없습니다.
패키지 사용량 오류
패키지 사용량 오류 그룹의HRESULT 오류 코드입니다.
파트 URI 오류
파트 URI 오류 그룹의HRESULT 오류 코드입니다.

설명

특정 파트를 나타내는 파트 개체의 IOpcPart 인터페이스 포인터를 검색하려면 PartExists 메서드를 호출하고 파트 이름을 전달하여 부품이 집합에 표시되는지 확인합니다. 이 경우 GetPart 메서드를 호출하고 파트 이름을 전달하여 IOpcPart 인터페이스 포인터를 검색합니다.

파트 URI 개체가 관계 파트의 파트 이름을 나타내는 경우 관계 부분이 집합에 포함되지 않기 때문에 이 메서드는 실패합니다.

IOpcPart 인터페이스는 파트의 속성에 대한 액세스를 제공합니다. 이러한 속성에 대한 자세한 내용은 파트 개요IOpcPart를 참조하세요.

스레드 보안

개체 패키징은 스레드로부터 안전하지 않습니다.

자세한 내용은 패키징 API를 사용한 시작 참조하세요.

요구 사항

요구 사항
지원되는 최소 클라이언트 Windows 7 [데스크톱 앱만 해당]
지원되는 최소 서버 Windows Server 2008 R2 [데스크톱 앱만 해당]
대상 플랫폼 Windows
헤더 msopc.h

추가 정보

패키징 API를 사용하여 시작

IOpcPartSet

개요

패키징 API 참조

패키징 API 샘플

패키징 오류

파트 개요

참조