다음을 통해 공유


IOpcRelationship::GetId 메서드(msopc.h)

관계의 고유 식별자를 가져옵니다.

구문

HRESULT GetId(
  [out, retval] LPWSTR *relationshipIdentifier
);

매개 변수

[out, retval] relationshipIdentifier

관계의 식별자입니다.

관계의 식별자는 임의이며 패키지에 로컬이며, 따라서 입니다.

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

반환 값

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

반환 코드 Description
S_OK
메서드가 성공했습니다.
E_POINTER
relationshipIdentifier 매개 변수는 NULL입니다.

설명

관계의 식별자는 패키지에 대해 임의적이고 로컬이기 때문에 관계를 찾는 데 유용하지 않습니다.

관심 있는 부분을 찾는 확실한 방법은 관계 유형을 사용하는 것입니다.

부품을 찾으려면 몇 가지 단계가 필요합니다. 파트 찾기에 대한 자세한 내용은 핵심 속성 파트 찾기를 참조하세요.

이 메서드는 relationshipIdentifier에서 반환된 문자열에서 사용하는 메모리를 할당합니다. 메서드가 성공하면 CoTaskMemFree 함수를 호출하여 메모리를 해제합니다.

관계에 대한 자세한 내용은 오픈 패키징 규칙 기본 사항ECMA-376 OpenXML, 1차 버전, 2부: OPC(Open Packaging Conventions)를 참조하세요.

스레드 보안

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

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

요구 사항

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

추가 정보

ECMA-376 OpenXML

외부 리소스

핵심 속성 파트 찾기

패키징 API를 사용하여 시작

IOpcRelationship

IOpcRelationshipSet

Open Packaging Conventions Fundamentals

개요

패키징 API 참조

패키징 API 샘플

참조

관계 개요

W3C 권장 사항, XML 스키마 2부: Datatypes Second Edition