Metode IXpsSignatureBlock::CreateRequest (xpsdigitalsignature.h)

Artikel
03/15/2023

Membuat antarmuka IXpsSignatureRequest baru dan menambahkannya ke blok tanda tangan.

Sintaks

HRESULT CreateRequest(
  [in]          LPCWSTR              requestId,
  [out, retval] IXpsSignatureRequest **signatureRequest
);

Parameter

[in] requestId

String yang secara unik mengidentifikasi permintaan tanda tangan baru dalam blok tanda tangan. Agar metode menghasilkan string ID, atur parameter ini ke NULL.

[out, retval] signatureRequest

Penunjuk ke antarmuka IXpsSignatureRequest baru. Jika akses ke antarmuka permintaan 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_UNEXPECTED	Antarmuka tidak terhubung ke pengelola tanda tangan, atau requestId adalah NULL dan string ID unik tidak dapat dihasilkan.

Keterangan

Permintaan tanda tangan baru harus memiliki ID permintaan unik; tidak ada dua permintaan yang mungkin memiliki string ID yang sama.

Membuat permintaan baru menandai blok tanda tangan sebagai kotor dan menghasilkan konten baru untuk bagian SignatureDefinitions. Ketika paket XPS diserialisasikan, konten baru akan menimpa konten sebelumnya di bagian SignatureDefinitions.

Persyaratan


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