IOpcSignatureReferenceSet::Create 메서드(msopc.h)

아티클
02/29/2024

서명할 XML 요소에 대한 참조를 나타내는 IOpcSignatureReference 인터페이스 포인터를 만듭니다.

구문

HRESULT Create(
  [in]          IUri                        *referenceUri,
  [in]          LPCWSTR                     referenceId,
  [in]          LPCWSTR                     type,
  [in]          LPCWSTR                     digestMethod,
  [in]          OPC_CANONICALIZATION_METHOD transformMethod,
  [out, retval] IOpcSignatureReference      **reference
);

매개 변수

[in] referenceUri

참조된 XML 요소의 URI입니다.

이 매개 변수의 값을 "#"을 나타내는 URI로 설정하고 참조된 요소의 Id 특성 값인 "#<elementIdValue>"를 설정합니다.

예제는 설명 섹션을 참조하세요.

[in] referenceId

서명 태그의 참조를 나타내는 Reference 요소의 Id 특성입니다. Id 특성을 생략하려면 이 매개 변수 값을 NULL로 설정합니다.

[in] type

서명 태그의 참조를 나타내는 Reference 요소의 Type 특성입니다. Type 특성을 생략하려면 이 매개 변수 값을 NULL로 설정합니다.

[in] digestMethod

참조할 XML 태그에 사용할 다이제스트 메서드입니다. 기본 다이제스트 메서드를 사용하려면 이 매개 변수 값을 NULL로 설정합니다.

중요IOpcDigitalSignatureManager::Sign이 호출되기 전에 IOpcSigningOptions::SetDefaultDigestMethod 메서드를 호출하여 기본 다이제스트 메서드를 설정해야 합니다.

[in] transformMethod

XML 태그를 참조하는 데 사용할 정식화 메서드입니다.

[out, retval] reference

서명할 XML 요소에 대한 참조를 나타내는 새 IOpcSignatureReference 인터페이스 포인터입니다.

반환 값

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

반환 코드/값	Description
S_OK	메서드가 성공했습니다.
E_INVALIDARG	transformMethod 매개 변수에 전달된 값이 유효한 OPC_CANONICALIZATION_METHOD 열거형 값이 아닙니다.
E_POINTER	referenceUri 매개 변수는 NULL입니다.
OPC_E_DS_PACKAGE_REFERENCE_URI_RESERVED 0x80510025	패키지 Object에 대한 서명의 Reference 요소의 예약된 URI 특성 값이 사용자 지정 Object 요소에 대한 Reference의 URI 특성 값으로 사용되고 있습니다.

설명

이 메서드는 서명이 생성될 때 서명된 XML 요소에 대한 참조를 만듭니다. 참조된 요소는 애플리케이션별 Object 요소 또는 애플리케이션별Object의 자식일 수 있습니다.

서명에 대한 XML 요소를 참조하려면 다음 표와 같이 referenceUri 매개 변수 값을 "#"을 나타내는 URI와 참조된 요소의 Id 특성 값을 차례로 설정합니다.

referenceUri 값(String)으로	참조된 요소	요소 설명
"#idMyCustomObject"	"<Object Id="idMyCustomObject">...</Object>"	애플리케이션별 Object 요소입니다.
"#idMyElement"	"<Object><MyElement Id="idMyElement">...</MyElement>...</Object>"	애플리케이션별 개체의 자식 요소 입니다.

이 메서드는 서명할 패키지별 Object 요소에 대한 참조를 만들지 않습니다. 해당 참조는 서명이 생성될 때 자동으로 만들어집니다.

IOpcSignatureReference 인터페이스 포인터가 만들어지고 집합에 추가되면 패키지가 저장되면 해당 포인터가 나타내는 참조가 저장됩니다.

스레드 보안

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

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

요구 사항

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