IOpcPartUri::GetSourceUri 메서드(msopc.h)

관계 부분에 저장된 관계의 원본 URI를 가져옵니다. 현재 파트 URI 개체는 관계 파트의 파트 이름을 나타냅니다.

구문

HRESULT GetSourceUri(
  [out, retval] IOpcUri **sourceUri
);

[out, retval] sourceUri

관계 파트에 저장된 관계 원본의 URI를 나타내는 OPC URI 개체의 IOpcUri 인터페이스에 대한 포인터입니다.

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

반환 코드/값	Description
S_OK	메서드가 성공했습니다.
E_POINTER	sourceUri 매개 변수는 NULL입니다.
OPC_E_RELATIONSHIP_URI_REQUIRED 0x80510003	관계 파트의 파트 이름은 필수이지만 파트 이름은 관계 파트의 이름이 아닙니다. 관계 파트의 파트 이름에 대한 자세한 내용은 OPC를 참조하세요.
CreateUri 함수 오류	CreateUri 함수의 HRESULT 오류 코드입니다.
WinINet 오류	WinINet API의 HRESULT 오류 코드입니다.

현재 파트 URI 개체가 패키지 관계("/_rels/.rels")를 저장하는 관계 파트의 파트 이름을 나타내는 경우 sourceUri 에 반환된 OPC URI 개체는 패키지 루트("/")를 나타냅니다.

현재 파트 URI 개체가 관계 파트의 파트 이름이 아닌 경우 이 메서드는 OPC_E_RELATIONSHIP_URI_REQUIRED 오류와 함께 실패합니다. 관계 파트 이름에 대한 구문은 OPC에 지정됩니다.

다음 표에서는 이 메서드에서 반환할 가능한 현재 파트 URI 및 원본 URI를 보여 줍니다.

현재 파트 URI	현재 파트 URI 설명	원본 URI	원본 URI 설명	반환 값
/mydoc/_rels/picture.jpg.rels	관계 파트의 파트 이름	/mydoc/picture.jpg	현재 파트 URI 개체로 표시되는 Relationships 파트에 저장된 관계의 원본인 파트의 이름입니다.	S_OK
/_rels/.rels	관계 파트의 파트 이름	/	패키지 루트; 현재 파트 URI 개체로 표시되는 관계 파트에 저장된 관계의 원본	S_OK
/mydoc/image/chart1.jpg	관계 부분이 아닌 파트의 파트 이름	Undefined	Undefined	OPC_E_RELATIONSHIP_URI_REQUIRED
/_rels/a.jpg	관계 부분이 아닌 파트의 파트 이름	Undefined	Undefined	OPC_E_RELATIONSHIP_URI_REQUIRED

이 메서드의 동작과 성능은 지원되는 모든 Windows 버전에서 동일합니다. 자세한 내용은 패키징 API를 사용한 시작 및 Windows Vista용 플랫폼 업데이트를 참조하세요.

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

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