struktur CRYPTPROTECT_PROMPTSTRUCT (dpapi.h)

Struktur CRYPTPROTECT_PROMPTSTRUCT menyediakan teks perintah dan informasi tentang kapan dan di mana perintah tersebut akan ditampilkan saat menggunakan fungsi CryptProtectData dan CryptUnprotectData .

Important

Tidak digunakan lagi — tanggal penghapusan: April 2027. Alur enkripsi dan dekripsi berbasis prompt interaktif yang disediakan oleh struktur ini (CRYPTPROTECT_PROMPT_ON_PROTECT dan CRYPTPROTECT_PROMPT_ON_UNPROTECT) akan dihapus pada bulan April 2027. Aplikasi yang mengandalkan alur berbasis perintah harus bermigrasi sebelum tanggal tersebut; setelah penghapusan, upaya dekripsi yang bergantung pada alur tersebut akan gagal dan data tidak akan lagi dapat dipulihkan melaluinya.

Apa yang TIDAK terpengaruh: Penggunaan non-interaktif CryptProtectData dan CryptUnprotectData (meneruskan NULL untuk pPromptStruct, atau menyediakan struct dengan dwPromptFlags diatur ke 0) tidak terpengaruh.

Tindakan yang diperlukan: Perbarui panggilan apa pun ke CryptProtectData atau CryptUnprotectData yang meneruskan CRYPTPROTECT_PROMPTSTRUCT dengan CRYPTPROTECT_PROMPT_ON_PROTECT atau CRYPTPROTECT_PROMPT_ON_UNPROTECT mengatur. Lewati NULL untuk pPromptStruct, atau lewati struct dengan dwPromptFlags diatur ke 0. Tidak ada penggantian untuk perilaku prompt interaktif itu sendiri.

Syntax

typedef struct _CRYPTPROTECT_PROMPTSTRUCT {
  DWORD   cbSize;
  DWORD   dwPromptFlags;
  HWND    hwndApp;
  LPCWSTR szPrompt;
} CRYPTPROTECT_PROMPTSTRUCT, *PCRYPTPROTECT_PROMPTSTRUCT;

Members

cbSize

Ukuran, dalam byte, dari struktur ini.

dwPromptFlags

Bendera DWORD yang menunjukkan kapan perintah kepada pengguna akan ditampilkan. Nilai dwPromptFlags saat ini adalah sebagai berikut.

Nilai	Meaning
CRYPTPROTECT_PROMPT_ON_PROTECT	Bendera ini digunakan untuk memberikan permintaan untuk fase perlindungan.
CRYPTPROTECT_PROMPT_ON_UNPROTECT	Bendera ini dapat dikombinasikan dengan CRYPTPROTECT_PROMPT_ON_PROTECT untuk memberlakukan kebijakan UI (antarmuka pengguna) pemanggil. Ketika CryptUnprotectData dipanggil, dwPromptFlags yang ditentukan dalam panggilan CryptProtectData diberlakukan.

hwndApp

Handel jendela ke jendela induk.

szPrompt

String yang berisi teks perintah yang akan ditampilkan.

Requirements

Requirement	Nilai
Klien minimum yang didukung	Windows XP [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Header	dpapi.h

Baca juga

CryptProtectData

CryptUnprotectData