struttura CRYPTPROTECT_PROMPTSTRUCT (dpapi.h)

La struttura CRYPTPROTECT_PROMPTSTRUCT fornisce il testo di un prompt e informazioni su quando e dove deve essere visualizzato il prompt quando si usano le funzioni CryptProtectData e CryptUnprotectData .

Importante

Deprecato — data di rimozione: aprile 2027. Il flusso interattivo di crittografia e decrittografia basato su prompt fornito da questa struttura (CRYPTPROTECT_PROMPT_ON_PROTECT e CRYPTPROTECT_PROMPT_ON_UNPROTECT) verrà rimosso nell'aprile 2027. Le applicazioni che si basano su flussi basati su prompt devono eseguire la migrazione prima di tale data; dopo la rimozione, i tentativi di decrittografia che dipendono da tali flussi avranno esito negativo e i dati non saranno più recuperabili tramite di essi.

Cosa NON è interessato: L'uso non interattivo di CryptProtectData e CryptUnprotectData (passando NULL per pPromptStructo fornendo uno struct con dwPromptFlags impostato su 0) non è interessato.

Azione richiesta: Aggiornare tutte le chiamate a CryptProtectData o CryptUnprotectData che passano un CRYPTPROTECT_PROMPTSTRUCT oggetto con CRYPTPROTECT_PROMPT_ON_PROTECT o CRYPTPROTECT_PROMPT_ON_UNPROTECT impostato. Passare NULL per pPromptStructo passare uno struct con dwPromptFlags impostato su 0. Non esiste alcuna sostituzione per il comportamento interattivo del prompt stesso.

Sintassi

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

Members

cbSize

Dimensione, in byte, di questa struttura.

dwPromptFlags

Flag DWORD che indicano quando viene richiesto all'utente di essere visualizzato. I valori dwPromptFlags correnti sono i seguenti.

Value	Meaning
CRYPTPROTECT_PROMPT_ON_PROTECT	Questo flag viene usato per fornire la richiesta della fase di protezione.
CRYPTPROTECT_PROMPT_ON_UNPROTECT	Questo flag può essere combinato con CRYPTPROTECT_PROMPT_ON_PROTECT per applicare i criteri dell'interfaccia utente del chiamante. Quando viene chiamato CryptUnprotectData , vengono applicati i dwPromptFlags specificati nella chiamata CryptProtectData .

hwndApp

Handle di finestra nella finestra padre.

szPrompt

Stringa contenente il testo di una richiesta da visualizzare.

Requisiti

Requirement	Value
Client minimo supportato	Windows XP [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Header	dpapi.h

Vedere anche

CryptProtectData

CryptUnprotectData