CRYPTPROTECT_PROMPTSTRUCT構造体 (dpapi.h)

CRYPTPROTECT_PROMPTSTRUCT構造体は、プロンプトのテキストと、CryptProtectData 関数と CryptUnprotectData 関数を使用するときにプロンプトを表示するタイミングと場所に関する情報を提供します。

Important

非推奨 — 削除日: 2027 年 4 月。 この構造体 (CRYPTPROTECT_PROMPT_ON_PROTECT および CRYPTPROTECT_PROMPT_ON_UNPROTECT) によって提供される対話型のプロンプト ベースの暗号化と復号化フローは、2027 年 4 月に削除されます。 プロンプト ベースのフローに依存するアプリケーションは、その日付より前に移行する必要があります。削除後、これらのフローに依存する復号化の試行は失敗し、データはそれらを介して回復できなくなります。

影響を受けないことを次に示します。CryptProtectData と CryptUnprotectData の非対話型の使用 (pPromptStructのNULLの受け渡し、または dwPromptFlags を 0 に設定した構造体の提供) は影響を受けません。

必要なアクション:CRYPTPROTECT_PROMPT_ON_PROTECTまたは CRYPTPROTECT_PROMPT_ON_UNPROTECT セットでCRYPTPROTECT_PROMPTSTRUCTを渡す CryptProtectData または CryptUnprotectData への呼び出しをすべて更新します。 pPromptStructのNULLを渡すか、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

表示するプロンプトのテキストを含む文字列。

要件

Requirement Value
サポートされる最小クライアント Windows XP [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2003 (デスクトップ アプリのみ)
Header dpapi.h

参照

CryptProtectData

CryptUnprotectData

  • 最終更新: