IOpcUri::CombinePartUri 메서드(msopc.h)

지정된 상대 URI에서 참조하는 파트의 파트 이름을 형성합니다. 파트의 지정된 상대 URI는 현재 OPC URI 개체로 표시되는 URI에 대해 확인됩니다.

구문

HRESULT CombinePartUri(
  [in]          IUri        *relativeUri,
  [out, retval] IOpcPartUri **combinedUri
);

[in] relativeUri

파트의 상대 URI에 대한 IUri 인터페이스에 대한 포인터입니다.

파트 이름을 나타내는 파트 URI 개체를 형성하기 위해 이 입력 URI는 현재 OPC URI 개체로 표시되는 URI에 대해 확인됩니다. 따라서 입력 URI는 현재 OPC URI 개체가 나타내는 URI를 기준으로 해야 합니다.

이 URI에는 조각 구성 요소가 포함될 수 있습니다. 그러나 조각은 무시되고 형성될 부품 이름에 포함되지 않습니다. RFC 3986: URI 제네릭 구문에 설명된 대로 조각 구성 요소 앞에 '#'이 있습니다.

[out, retval] combinedUri

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

파트 URI 개체는 현재 OPC URI 개체가 나타내는 URI에 대해 relativeUri 의 상대 URI를 확인하여 형성됩니다.

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

반환 코드/값	Description
S_OK	메서드가 성공했습니다.
E_FAIL	CoInternetCombineUrl 함수가 잘못된 크기를 반환했습니다.
E_POINTER	relativeUri 및 combinedUri 매개 변수 중 하나 이상이 NULL입니다.
E_UNEXPECTED	CoInternetCombineUrl 함수에 필요한 버퍼의 크기가 예기치 않게 변경되었습니다.
OPC_E_NONCONFORMING_URI 0x80510001	부품 이름은 OPC 표준에 지정된 규칙을 준수하지 않습니다.
OPC_E_RELATIVE_URI_REQUIRED 0x80510002	파트 이름은 절대 URI일 수 없습니다. 절대 URI는 RFC 3986: URI 제네릭 구문에 설명된 대로 스키마 구성 요소 다음에 ":"로 시작합니다.
CoInternetCombineUrl 함수 오류	CoInternetCombineUrl 함수의 HRESULT 오류 코드입니다.
CreateUri 함수 오류	CreateUri 함수의 HRESULT 오류 코드입니다.
WinINet 오류	WinINet API의 HRESULT 오류 코드입니다.

입력 및 출력 예제:

이 메서드를 사용하여 파트 이름을 resolve 방법에 대한 자세한 내용은 대상 URI에서 파트 이름 해결을 참조하세요.

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

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


지원되는 최소 클라이언트	Windows 7, Windows Vista SP2 및 Windows Vista용 플랫폼 업데이트가 포함된 Windows Vista [데스크톱 앱 \| UWP 앱]
지원되는 최소 서버	Windows Server 2008 R2, Windows Server 2008 SP2 및 Windows Server 2008용 플랫폼 업데이트 [데스크톱 앱 \| UWP 앱]
대상 플랫폼	Windows
헤더	msopc.h