CRYPTPROTECT_PROMPTSTRUCT结构(dpapi.h)

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
此标志用于提供保护阶段的提示。
CRYPTPROTECT_PROMPT_ON_UNPROTECT
此标志可以与CRYPTPROTECT_PROMPT_ON_PROTECT结合使用,以强制调用方实施 UI(用户界面)策略。 调用 CryptUnprotectData 时,将强制实施 CryptProtectData 调用中指定的 dwPromptFlags。

hwndApp

父窗口的窗口句柄。

szPrompt

包含要显示的提示文本的字符串。

要求

Requirement Value
最低支持的客户端 Windows XP [仅限桌面应用]
支持的最低服务器 Windows Server 2003 [仅限桌面应用]
Header dpapi.h

另请参阅

CryptProtectData

CryptUnprotectData