IOpcRelationshipSet::CreateRelationship 메서드(msopc.h)

아티클
03/05/2024

지정된 관계를 나타내는 관계 개체를 만든 다음 개체의 IOpcRelationship 인터페이스에 대한 포인터를 설정에 추가합니다.

구문

HRESULT CreateRelationship(
  [in]          LPCWSTR             relationshipIdentifier,
  [in]          LPCWSTR             relationshipType,
  [in]          IUri                *targetUri,
  [in]          OPC_URI_TARGET_MODE targetMode,
  [out, retval] IOpcRelationship    **relationship
);

매개 변수

[in] relationshipIdentifier

관계 개체로 나타낼 관계의 고유 식별자입니다. 임의로 생성된 식별자를 사용하려면 이 매개 변수에 NULL 을 전달합니다.

유효한 식별자는 w3C 권장 사항, XML 스키마 파트 2: Datatypes Second Edition(http://www.w3.org/TR/xmlschema-2/#ID)의 섹션 3.3.8 ID에 설명된 xsd:ID에 대한 제한을 준수합니다.

[in] relationshipType

관계 개체로 나타낼 관계의 역할을 정의하는 관계 형식입니다.

[in] targetUri

관계 개체로 나타낼 관계의 대상에 대한 URI입니다.

targetMode의 값이 OPC_URI_TARGET_MODE_INTERNAL 대상은 부분이며 URI는 관계의 원본을 기준으로 해야 합니다.

targetMode의 값이 OPC_URI_TARGET_MODE_EXTERNAL 대상은 패키지 외부의 리소스이며 URI는 절대 또는 패키지 위치를 기준으로 할 수 있습니다.

관계 대상의 URI에 대한 자세한 내용은 OPC를 참조하세요.

[in] targetMode

관계 개체로 나타낼 관계의 대상이 패키지의 내부 또는 외부인지 여부를 나타내는 값입니다.

[out, retval] relationship

관계를 나타내는 관계 개체의 IOpcRelationship 인터페이스에 대한 포인터입니다.

새 개체에 대한 포인터가 필요하지 않은 경우 이 매개 변수는 NULL 일 수 있습니다.

반환 값

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

반환 코드/값	Description
S_OK	메서드가 성공했습니다.
E_INVALIDARG	targetMode 매개 변수에 전달된 값이 유효한 OPC_URI_TARGET_MODE 열거형 값이 아닙니다.
E_POINTER	relationshipType 및 targetUri 매개 변수 중 하나 이상이 NULL입니다.
OPC_E_DUPLICATE_RELATIONSHIP 0x80510013	동일한 식별자와의 관계가 현재 패키지에 이미 있습니다.
OPC_E_INVALID_RELATIONSHIP_ID 0x80510010	관계의 ID 특성이 OPC에 지정된 규칙을 준수하지 않습니다.
OPC_E_INVALID_RELATIONSHIP_TARGET 0x80510012	targetUri의 URI는 절대이며 targetMode의 값은 OPC_URI_TARGET_MODE_INTERNAL. 이 대상 모드를 지정할 때 대상의 URI는 상대적이어야 합니다.
OPC_E_INVALID_RELATIONSHIP_TARGET 0x80510012	관계의 Target 특성이 OPC에 지정된 규칙을 준수하지 않습니다.
OPC_E_INVALID_RELATIONSHIP_TYPE 0x80510011	관계의 Type 특성이 OPC에 지정된 규칙을 준수하지 않습니다.
패키지 사용 오류	패키지 사용 오류 그룹의HRESULT 오류 코드입니다.
파트 URI 오류	파트 URI 오류 그룹의HRESULT 오류 코드입니다.

설명

관계 개체가 만들어지고 해당 개체에 대한 포인터가 집합에 추가되면 패키지가 저장되면 해당 개체가 나타내는 관계가 저장됩니다.

IOpcRelationship 인터페이스는 관계 속성에 대한 액세스를 제공합니다. 이러한 속성에 대한 자세한 내용은 관계 개요 및 IOpcRelationship을 참조하세요.

스레드 보안

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

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

요구 사항

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