Fungsi CryptUIWizDigitalSign (cryptuiapi.h)

[Fungsi CryptUIWizDigitalSign tersedia untuk digunakan dalam sistem operasi yang ditentukan di bagian Persyaratan. Ini mungkin diubah atau tidak tersedia dalam versi berikutnya.]

Fungsi CryptUIWizDigitalSign secara digital menandatangani dokumen atau BLOB. Dokumen atau BLOB dapat ditandatangani dengan atau tanpa interaksi pengguna.

Sintaks

BOOL CryptUIWizDigitalSign(
  [in]            DWORD                              dwFlags,
  [in, optional]  HWND                               hwndParent,
  [in, optional]  LPCWSTR                            pwszWizardTitle,
  [in]            PCCRYPTUI_WIZ_DIGITAL_SIGN_INFO    pDigitalSignInfo,
  [out, optional] PCCRYPTUI_WIZ_DIGITAL_SIGN_CONTEXT *ppSignContext
);

Parameter

[in] dwFlags

Berisi bendera yang mengubah perilaku fungsi. Ini bisa nol atau nilai berikut.

Nilai	Makna
CRYPTUI_WIZ_NO_UI 0x0001	Fungsi ini akan menandatangani dokumen berdasarkan informasi dalam struktur CRYPTUI_WIZ_DIGITAL_SIGN_INFO yang diarahkan oleh parameter pDigitalSignInfo tanpa menampilkan antarmuka pengguna apa pun. Jika bendera ini tidak ditentukan, fungsi ini akan menampilkan wizard untuk memandu pengguna melalui proses penandatanganan.

[in, optional] hwndParent

Gagang jendela yang akan digunakan sebagai induk kotak dialog yang dibuat fungsi ini. Parameter ini diabaikan jika bendera CRYPTUI_WIZ_NO_UI diatur dalam dwFlags.

[in, optional] pwszWizardTitle

Penunjuk ke string Unicode yang dihentikan null yang berisi judul yang akan digunakan dalam kotak dialog yang dibuat fungsi ini. Parameter ini diabaikan jika bendera CRYPT_WIZ_NO_UI diatur dalam dwFlags. Jika parameter ini NULL, judul default akan digunakan.

[in] pDigitalSignInfo

Penunjuk ke struktur CRYPTUI_WIZ_DIGITAL_SIGN_INFO yang berisi informasi tentang proses penandatanganan.

[out, optional] ppSignContext

Penunjuk ke penunjuk struktur CRYPTUI_WIZ_DIGITAL_SIGN_CONTEXT yang menerima BLOB yang ditandatangani. Setelah selesai menggunakan struktur ini, Anda harus membebaskan memori dengan meneruskan pointer ini ke fungsi CryptUIWizFreeDigitalSignContext . Parameter ini dapat berupa NULL jika BLOB yang ditandatangani tidak diperlukan.

Nilai kembali

Jika fungsi berhasil, nilai yang dikembalikan adalah TRUE.

Jika fungsi gagal, nilai yang dikembalikan adalah FALSE. Untuk informasi kesalahan yang diperluas, hubungi GetLastError.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows XP [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Target Platform	Windows
Header	cryptuiapi.h
Pustaka	Cryptui.lib
DLL	Cryptui.dll

Lihat juga

CRYPTUI_WIZ_DIGITAL_SIGN_CONTEXT

CRYPTUI_WIZ_DIGITAL_SIGN_INFO

CryptUIWizFreeDigitalSignContext