IOpcSignatureReferenceSet::Buat metode (msopc.h)
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.
[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 |
---|---|
|
Metode berhasil. |
|
Nilai yang diteruskan dalam parameter transformMethod bukan nilai enumerasi OPC_CANONICALIZATION_METHOD yang valid. |
|
Parameter referenceUri adalah NULL. |
|
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 |
Lihat juga
Gambaran Umum
Panduan Pemrograman API Pengemasan
Kemasan Antarmuka Tanda Tangan Digital
Referensi