CRYPTPROTECT_PROMPTSTRUCT結構(dpapi.h)

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
此旗幟用於提供保護階段的提示。
CRYPTPROTECT_PROMPT_ON_UNPROTECT
此旗標可與 CRYPTPROTECT_PROMPT_ON_PROTECT 結合,以強制呼叫者的 UI(使用者介面)政策。 當呼叫 CryptUnprotectData 時,會強制執行 CryptProtectData 呼叫中指定的 dwPromptFlags。

hwndApp

視窗柄指向父視窗。

szPrompt

包含要顯示提示詞文字的字串。

Requirements

Requirement Value
最低支援的用戶端 Windows XP [僅限傳統型應用程式]
支援的最低伺服器 Windows Server 2003 [僅限傳統型應用程式]
Header dpapi.h

也請參閱

CryptProtectData

CryptUnprotectData