CRYPTPROTECT_PROMPTSTRUCT結構提供提示詞的文字,以及使用 CryptProtectData 和 CryptUnprotectData 函式時該提示何時、在哪裡顯示的資訊。
Important
已棄用 — 移除日期:2027年4月。 此結構CRYPTPROTECT_PROMPT_ON_PROTECT 所提供的互動式基於提示的加密與解密流程(及 CRYPTPROTECT_PROMPT_ON_UNPROTECT)將於 2027 年 4 月被移除。 依賴提示式流程的應用程式必須在此日期前遷移;移除後,依賴這些流程的解密嘗試將失敗,資料將無法再透過這些流程恢復。
不受影響的事項: 非互動式使用 CryptProtectData 與 CryptUnprotectData (傳遞 NULLpPromptStruct,或提供設 dwPromptFlags 為 0 的結構體)則不受影響。
必須採取行動: 更新任何對 CryptProtectData 或 CryptUnprotectData 的呼叫,只要這些呼叫傳遞 CRYPTPROTECT_PROMPTSTRUCT 了 with CRYPTPROTECT_PROMPT_ON_PROTECT 或 CRYPTPROTECT_PROMPT_ON_UNPROTECT set。 要麼通過 NULL , pPromptStruct要麼通過一個設 dwPromptFlags 為 0 的結構體。 互動式提示行為本身無法取代。
句法
typedef struct _CRYPTPROTECT_PROMPTSTRUCT {
DWORD cbSize;
DWORD dwPromptFlags;
HWND hwndApp;
LPCWSTR szPrompt;
} CRYPTPROTECT_PROMPTSTRUCT, *PCRYPTPROTECT_PROMPTSTRUCT;
Members
cbSize
這個 結構的大小,以位元組為單位。
dwPromptFlags
DWORD 標誌指示何時要顯示給使用者。 目前 的 dwPromptFlags 值如下。
| Value | Meaning |
|---|---|
|
此旗幟用於提供保護階段的提示。 |
|
此旗標可與 CRYPTPROTECT_PROMPT_ON_PROTECT 結合,以強制呼叫者的 UI(使用者介面)政策。 當呼叫 CryptUnprotectData 時,會強制執行 CryptProtectData 呼叫中指定的 dwPromptFlags。 |
hwndApp
視窗柄指向父視窗。
szPrompt
包含要顯示提示詞文字的字串。
Requirements
| Requirement | Value |
|---|---|
| 最低支援的用戶端 | Windows XP [僅限傳統型應用程式] |
| 支援的最低伺服器 | Windows Server 2003 [僅限傳統型應用程式] |
| Header | dpapi.h |