CRYPTPROTECT_PROMPTSTRUCT结构提供提示文本以及有关使用 CryptProtectData 和 CryptUnprotectData 函数时显示该提示的时间和位置的信息。
Important
已弃用 — 删除日期:2027 年 4 月。 此结构CRYPTPROTECT_PROMPT_ON_PROTECTCRYPTPROTECT_PROMPT_ON_UNPROTECT提供的基于提示的交互式加密和解密流将于 2027 年 4 月删除。 依赖于基于提示的流的应用程序必须在该日期之前迁移;删除后,依赖于这些流的解密尝试将失败,并且数据将无法再通过它们进行恢复。
受影响的内容:CryptProtectData 和 CryptUnprotectData 的非交互式使用(为 NULLpPromptStruct 提供dwPromptFlags设置为 0 的结构)不受影响。
所需操作:更新对通过或CRYPTPROTECT_PROMPT_ON_UNPROTECT设置的 CRYPTPROTECT_PROMPTSTRUCTCRYPTPROTECT_PROMPT_ON_PROTECTCryptProtectData 或 CryptUnprotectData 的任何调用。 传递 NULL 或 pPromptStruct传递设置为 0 的结构 dwPromptFlags 。 交互式提示行为本身无法替代。
Syntax
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
包含要显示的提示文本的字符串。
要求
| Requirement | Value |
|---|---|
| 最低支持的客户端 | Windows XP [仅限桌面应用] |
| 支持的最低服务器 | Windows Server 2003 [仅限桌面应用] |
| Header | dpapi.h |