CRYPTPROTECT_PROMPTSTRUCT

[This is preliminary documentation and subject to change.]

The CRYPTPROTECT_PROMPTSTRUCT structure provides the text of a prompt and information about when and where that prompt is to be displayed when using the CryptProtectData and CryptUnprotectData functions.

typedef struct _CRYPTPROTECT_PROMPTSTRUCT{
  DWORD      cbSize;
  DWORD      dwPromptFlags;
  HWND       hwndApp;
  LPCWSTR    szPrompt;
} CRYPTPROTECT_PROMPTSTRUCT, *PCRYPTPROTECT_PROMPTSTRUCT;
 

Members

cbSize

The size of the data structure.

dwPromptFlags

DWORD flags that indicate when prompts to the user are to be displayed. Current dwPromptFlags values are:

CRYPTPROTECT_PROMPT_ON_PROTECT

This flag is used to provide the prompt the protect phase.

CRYPTPROTECT_PROMPT_ON_UNPROTECT

This flag may be combined with CRYPTPROTECT_PROMPT_ON_PROTECT to enforce the UI (user interface) policy of the caller. When CryptUnprotectData is called, the dwPromptFlags specified in the CryptProtectData call are enforced.

hwndApp

Window handle to the parent window.

szPrompt

A string containing the text of a prompt to be displayed.

See Also

CryptProtectData, CryptUnprotectData