Metode SignedCode.Sign

[Metode Tanda tangan tersedia untuk digunakan dalam sistem operasi yang ditentukan di bagian Persyaratan. Sebagai gantinya, gunakan Platform Invocation Services (PInvoke) untuk memanggil fungsi Win32 API SignerSignEx, SignerTimeStampEx, dan WinVerifyTrust untuk menandatangani konten dengan tanda tangan digital Authenticode. Untuk informasi tentang PInvoke, lihat Tutorial Pemanggilan Platform. .NET dan CryptoAPI melalui P/Invoke: Bagian 1 dan .NET dan CryptoAPI melalui P/Invoke: Subbagian Bagian 2 dari Perluasan Kriptografi .NET dengan CAPICOM dan P/Invoke mungkin juga berguna.]

Metode Tanda tangan membuat tanda tangan digital Authenticode dan menandatangani file yang dapat dieksekusi yang ditentukan dalam properti SignedCode.FileName .

Sintaks

SignedCode.Sign( _
  [ ByVal Signer ] _
)

Parameter

Penanda tangan [masuk, opsional]

Objek Penanda tangan yang memiliki akses ke kunci privat sertifikat yang digunakan untuk menandatangani kode. Nilai defaultnya adalah Null.

Nilai kembali

Metode ini tidak mengembalikan nilai.

Keterangan

Sebelum metode Tanda tangan dipanggil, file yang berisi kode harus ditentukan dalam properti FileName .

Jika file yang dapat dieksekusi sudah ditandatangani, metode ini menimpa tanda tangan yang ada.

Hasil berikut berlaku untuk nilai parameter Penanda tangan :

• Jika parameter Penanda tangan bukan NULL, metode ini menggunakan kunci privat yang ditujukkan oleh sertifikat terkait untuk mengenkripsi tanda tangan. 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 dengan kemampuan penandatanganan kode, sertifikat tersebut digunakan untuk membuat tanda tangan.
• 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 dengan kemampuan penandatanganan kode, 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 dengan kemampuan penandatanganan kode, metode gagal.

Metode ini menggunakan algoritma hash SHA-1.

Persyaratan

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