Metode SignedData.CoSign

[Metode CoSign tersedia untuk digunakan dalam sistem operasi yang ditentukan di bagian Persyaratan. Sebagai gantinya, gunakan Kelas SignedCms di dalam ruang nama System.Security.Cryptography.Pkcs .]

Metode CoSign membuat tanda tangan digital pada konten yang ditandatangani sebelumnya.

Sintaks

SignedData.CoSign( _
  [ ByVal Signer ], _
  [ ByVal EncodingType ] _
)

Parameter

Penanda tangan [masuk, opsional]

Referensi ke objek Penanda tangan penanda tangan data. Objek Penanda tangan harus memiliki akses ke kunci privat sertifikat yang digunakan untuk menandatangani. Parameter ini bisa NULL; untuk informasi selengkapnya, lihat Keterangan.

EncodingType [in, opsional]

Nilai enumerasi CAPICOM_ENCODING_TYPE yang menunjukkan bagaimana data yang ditandatangani akan dikodekan. Nilai defaultnya adalah CAPICOM_ENCODE_BASE64. Parameter ini bisa menjadi salah satu nilai berikut.

Nilai	Makna
CAPICOM_ENCODE_ANY	Jenis pengodean ini hanya digunakan ketika data input memiliki jenis pengodean yang tidak diketahui. Jika nilai ini digunakan untuk menentukan jenis pengodean output, CAPICOM_ENCODE_BASE64 akan digunakan sebagai gantinya. Diperkenalkan dalam CAPICOM 2.0.
CAPICOM_ENCODE_BASE64	Data disimpan sebagai string yang dikodekan base64.
CAPICOM_ENCODE_BINARY	Data disimpan sebagai urutan biner murni.

 

Nilai kembali

Metode ini mengembalikan string yang berisi data yang dikodekan dan ditandatangani.

Jika metode ini gagal, kesalahan akan dilemparkan. Objek Err akan berisi informasi tambahan tentang kesalahan tersebut.

Keterangan

Penting

Ketika metode ini dipanggil dari skrip web, skrip perlu menggunakan kunci privat Anda untuk membuat tanda tangan digital. Mengizinkan situs web yang tidak tepercaya menggunakan kunci privat Anda adalah risiko keamanan. Kotak dialog yang menanyakan apakah situs web dapat menggunakan kunci privat Anda muncul saat metode ini pertama kali dipanggil. Jika Anda memperbolehkan skrip menggunakan kunci privat Anda untuk membuat tanda tangan digital dan memilih "Jangan perlihatkan kotak dialog ini lagi," kotak dialog tidak akan lagi muncul untuk skrip apa pun dalam domain tersebut yang menggunakan kunci privat Anda untuk membuat tanda tangan digital. Namun, skrip di luar domain yang mencoba menggunakan kunci privat Anda untuk membuat tanda tangan digital masih akan menyebabkan kotak dialog ini muncul. Jika Anda tidak mengizinkan skrip untuk menggunakan kunci privat Anda dan memilih "Jangan tampilkan kotak dialog ini lagi," skrip dalam domain tersebut akan secara otomatis ditolak kemampuan untuk menggunakan kunci privat Anda untuk membuat tanda tangan digital.

 

Cosigners tidak dijamin berada dalam urutan tertentu.

Hasil berikut berlaku untuk nilai parameter Penanda tangan :

• Jika parameter Penanda tangan bukan NULL, metode ini menggunakan kunci privat yang diarahkan oleh sertifikat terkait untuk mengenkripsi kosignature. Jika kunci privat yang diacu oleh sertifikat tidak tersedia, metode gagal.
• Jika parameter Penanda tanganadalah NULL dan tepat ada satu sertifikat di CURRENT_USER penyimpanan MY yang memiliki akses ke kunci privat, sertifikat tersebut digunakan untuk membuat pencitraan bersama.
• Jika parameter Penanda tanganadalah NULL, nilai properti Settings.EnablePromptForCertificateUI benar, dan ada lebih dari satu sertifikat di penyimpanan CURRENT_USER MY dengan kunci privat yang tersedia, kotak dialog muncul yang memungkinkan pengguna untuk memilih sertifikat mana yang digunakan.
• Jika parameter Penanda tanganadalah NULL dan properti Settings.EnablePromptForCertificateUI salah, metode gagal.
• Jika parameter Penanda tanganadalah NULL dan tidak ada sertifikat di CURRENT_USER penyimpanan MY dengan kunci privat yang tersedia, metode gagal.

Persyaratan

Persyaratan	Nilai
Redistribusi	CAPICOM 2.0 atau yang lebih baru di Windows Server 2003 dan Windows XP
DLL	Capicom.dll

Lihat juga

Objek Kriptografi

SignedData