Metode IXpsSignatureManager::AddSignatureBlock (xpsdigitalsignature.h)

Artikel
03/13/2024

Membuat antarmuka IXpsSignatureBlock baru dan menambahkannya ke koleksi blok tanda tangan.

Sintaks

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

Parameter

[in] partName

Penunjuk ke antarmuka IOpcPartUri yang berisi URI bagian baru. Agar metode menghasilkan nama bagian, parameter ini dapat diatur ke NULL.

[in] fixedDocumentIndex

Nilai indeks bagian FixedDocument yang akan dikaitkan dengan blok tanda tangan baru.

[out, retval] signatureBlock

Penunjuk ke antarmuka IXpsSignatureBlock baru. Jika akses ke antarmuka baru tidak diperlukan, parameter ini dapat diatur ke NULL.

Nilai kembali

Metode mengembalikan HRESULT. Nilai yang mungkin termasuk, tetapi tidak terbatas pada, yang ada dalam tabel berikut. Untuk nilai pengembalian yang tidak tercantum dalam tabel ini, lihat Kesalahan XPS Digital Signature API dan Kesalahan Dokumen XPS.

Menampilkan kode	Deskripsi
S_OK	Metode berhasil.
E_INVALIDARG	fixedDocumentIndex mereferensikan dokumen tetap yang tidak ditemukan dalam paket XPS.
XPS_E_PACKAGE_NOT_OPENED	Paket XPS belum dibuka di pengelola tanda tangan.

Keterangan

Blok tanda tangan mewakili bagian SignatureDefinitions dalam paket XPS. Menurut bagian 10.2.2 dalam Spesifikasi Kertas XML, nol atau beberapa bagian SignatureDefinitions dapat dilampirkan ke setiap FixedDocument. Metode ini membuat bagian SignatureDefinitions baru dengan nama yang ditentukan, menautkannya dari bagian FixedDocument yang ditentukan oleh hubungan, membuat antarmuka IXpsSignatureBlock baru, dan menambahkan antarmuka baru ini ke koleksi blok tanda tangan internal.

Untuk mengambil blok tanda tangan, panggil metode GetSignatureBlocks .

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 7 [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 R2 [hanya aplikasi desktop]
Target Platform	Windows
Header	xpsdigitalsignature.h