IXpsSignatureManager::AddSignatureBlock 메서드(xpsdigitalsignature.h)

아티클
03/05/2024

새 IXpsSignatureBlock 인터페이스를 만들고 서명 블록 컬렉션에 추가합니다.

구문

HRESULT AddSignatureBlock(
  [in]          IOpcPartUri        *partName,
  [in]          UINT32             fixedDocumentIndex,
  [out, retval] IXpsSignatureBlock **signatureBlock
);

매개 변수

[in] partName

새 파트의 URI를 포함하는 IOpcPartUri 인터페이스에 대한 포인터입니다. 메서드가 파트 이름을 생성하려면 이 매개 변수를 NULL로 설정할 수 있습니다.

[in] fixedDocumentIndex

새 서명 블록이 연결될 FixedDocument 부분의 인덱스 값입니다.

[out, retval] signatureBlock

새 IXpsSignatureBlock 인터페이스에 대한 포인터입니다. 새 인터페이스에 액세스할 필요가 없는 경우 이 매개 변수를 NULL로 설정할 수 있습니다.

반환 값

이 메서드는 HRESULT를 반환합니다. 가능한 값에는 다음 표의 값이 포함되지만 이에 국한되지는 않습니다. 이 표에 나열되지 않은 반환 값은 XPS 디지털 서명 API 오류 및 XPS 문서 오류를 참조하세요.

반환 코드	Description
S_OK	메서드가 성공했습니다.
E_INVALIDARG	fixedDocumentIndex 는 XPS 패키지에서 찾을 수 없는 고정 문서를 참조합니다.
XPS_E_PACKAGE_NOT_OPENED	서명 관리자에서 XPS 패키지가 아직 열리지 않았습니다.

설명

서명 블록은 XPS 패키지의 SignatureDefinitions 부분을 나타냅니다. XML 용지 사양의 섹션 10.2.2에 따르면 각 FixedDocument에 0개 이상의 SignatureDefinitions 부분을 연결할 수 있습니다. 이 메서드는 지정된 이름을 가진 새 SignatureDefinitions 파트를 만들고, 지정된 FixedDocument 부분에서 관계로 연결하고, 새 IXpsSignatureBlock 인터페이스를 만들고, 이 새 인터페이스를 내부 서명 블록 컬렉션에 추가합니다.

서명 블록을 검색하려면 GetSignatureBlocks 메서드를 호출합니다 .

요구 사항

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