IOpcSignatureReferenceSet::Buat metode (msopc.h)

Artikel
08/25/2023

Membuat penunjuk antarmuka IOpcSignatureReference yang mewakili referensi ke elemen XML yang akan ditandatangani.

Sintaks

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

Parameter

[in] referenceUri

URI elemen XML yang direferensikan.

Atur nilai parameter ini ke URI yang mewakili "#" diikuti dengan nilai atribut Id dari elemen yang direferensikan: "#<elementIdValue>".

Misalnya, lihat bagian Keterangan.

[in] referenceId

Atribut Id dari elemen Referensi yang mewakili referensi dalam markup tanda tangan. Untuk menghilangkan atribut Id , atur nilai parameter ini ke NULL.

[in] type

Atribut Jenis elemen Referensi yang mewakili referensi dalam markup tanda tangan. Untuk menghilangkan atribut Type , atur nilai parameter ini ke NULL.

[in] digestMethod

Metode hash yang akan digunakan untuk markup XML yang akan direferensikan. Untuk menggunakan metode hash default, atur nilai parameter ini ke NULL.

Penting Metode digest default harus diatur dengan memanggil metode IOpcSigningOptions::SetDefaultDigestMethod sebelum IOpcDigitalSignatureManager::Sign dipanggil.

[in] transformMethod

Metode kanonisisasi yang akan digunakan untuk markup XML yang akan direferensikan.

[out, retval] reference

Penunjuk antarmuka IOpcSignatureReference baru yang mewakili referensi ke elemen XML yang akan ditandatangani.

Nilai kembali

Metode mengembalikan HRESULT. Nilai yang mungkin termasuk, tetapi tidak terbatas pada, yang ada dalam tabel berikut.

Mengembalikan kode/nilai	Deskripsi
S_OK	Metode berhasil.
E_INVALIDARG	Nilai yang diteruskan dalam parameter transformMethod bukan nilai enumerasi OPC_CANONICALIZATION_METHOD yang valid.
E_POINTER	Parameter referenceUri adalah NULL.
OPC_E_DS_PACKAGE_REFERENCE_URI_RESERVED 0x80510025	Nilai atribut URI yang dipesan dari elemen Referensi tanda tangan ke Objek paket sedang digunakan sebagai nilai atribut URI dari Referensi ke elemen Objek kustom.

Keterangan

Metode ini membuat referensi ke elemen XML yang ditandatangani saat tanda tangan dibuat. Elemen yang dirujuk dapat berupa elemen Objek khusus aplikasi atau anak dari Objek khusus aplikasi.

Untuk mereferensikan elemen XML untuk penandatanganan, atur nilai parameter referenceUri ke URI yang mewakili "#" diikuti dengan nilai atribut Id dari elemen yang direferensikan, seperti yang ditunjukkan dalam tabel berikut.

referenceUri Nilai sebagai String	Elemen Yang Dirujuk	Deskripsi Elemen
"#idMyCustomObject"	"<Object Id="idMyCustomObject">...</Object>"	Elemen Objek khusus aplikasi.
"#idMyElement"	"<Object><MyElement Id="idMyElement">...</MyElement>...</Object>"	Elemen anak dari Objek khusus aplikasi.

Metode ini tidak membuat referensi ke elemen Objek khusus paket yang akan ditandatangani; referensi tersebut dibuat secara otomatis saat tanda tangan dibuat.

Saat penunjuk antarmuka IOpcSignatureReference dibuat dan ditambahkan ke set, referensi yang diwakilinya disimpan saat paket disimpan.

Keamanan Thread

Objek pengemasan tidak aman untuk utas.

Untuk informasi selengkapnya, lihat Memulai PACKAGING API.

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	msopc.h