structure CRYPTPROTECT_PROMPTSTRUCT (dpapi.h)

La structure CRYPTPROTECT_PROMPTSTRUCT fournit le texte d’une invite et d’informations sur le moment et l’emplacement où cette invite doit être affichée lors de l’utilisation des fonctions CryptProtectData et CryptUnprotectData .

Important

Déprécié — date de suppression : avril 2027. Le flux interactif de chiffrement et de déchiffrement basé sur les invites fourni par cette structure (CRYPTPROTECT_PROMPT_ON_PROTECT et CRYPTPROTECT_PROMPT_ON_UNPROTECT) sera supprimé en avril 2027. Les applications qui s’appuient sur des flux basés sur des invites doivent migrer avant cette date ; après la suppression, les tentatives de déchiffrement qui dépendent de ces flux échouent et les données ne sont plus récupérables par leur intermédiaire.

Ce qui n’est pas affecté : L’utilisation non interactive de CryptProtectData et CryptUnprotectData (passage NULL pour pPromptStruct, ou fourniture d’un struct dont dwPromptFlags la valeur est définie sur 0) n’est pas affectée.

Action requise : Mettez à jour tous les appels à CryptProtectData ou CryptUnprotectData qui passent un CRYPTPROTECT_PROMPTSTRUCT appel avec CRYPTPROTECT_PROMPT_ON_PROTECT ou CRYPTPROTECT_PROMPT_ON_UNPROTECT défini. Passez NULL ou pPromptStructpassez un struct avec dwPromptFlags la valeur 0. Il n’existe aucun remplacement pour le comportement d’invite interactive lui-même.

Syntaxe

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

Members

cbSize

Taille, en octets, de cette structure.

dwPromptFlags

Indicateurs DWORD qui indiquent quand les invites à l’utilisateur doivent être affichées. Les valeurs dwPromptFlags actuelles sont les suivantes.

Value	Meaning
CRYPTPROTECT_PROMPT_ON_PROTECT	Cet indicateur est utilisé pour fournir l’invite de la phase de protection.
CRYPTPROTECT_PROMPT_ON_UNPROTECT	Cet indicateur peut être combiné avec CRYPTPROTECT_PROMPT_ON_PROTECT pour appliquer la stratégie d’interface utilisateur (interface utilisateur) de l’appelant. Lorsque CryptUnprotectData est appelé, les dwPromptFlags spécifiés dans l’appel CryptProtectData sont appliqués.

hwndApp

Handle de fenêtre vers la fenêtre parente.

szPrompt

Chaîne contenant le texte d’une invite à afficher.

Conditions requises

Requirement	Value
Client minimum requis	Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Header	dpapi.h

Voir aussi

CryptProtectData

CryptUnprotectData