CRYPTPROTECT_PROMPTSTRUCT Struktur (dpapi.h)

Die CRYPTPROTECT_PROMPTSTRUCT Struktur stellt den Text einer Eingabeaufforderung und Informationen dazu bereit, wann und wo diese Eingabeaufforderung angezeigt werden soll, wenn die Funktionen CryptProtectData und CryptUnprotectData verwendet werden.

Important

Veraltet – Entfernungsdatum: April 2027. Der interaktive eingabeaufforderungsbasierte Verschlüsselungs- und Entschlüsselungsfluss, der von dieser Struktur (CRYPTPROTECT_PROMPT_ON_PROTECT und CRYPTPROTECT_PROMPT_ON_UNPROTECT) bereitgestellt wird, wird im April 2027 entfernt. Anwendungen, die auf prompten basierten Flüssen basieren, müssen vor diesem Datum migriert werden; nach dem Entfernen können Entschlüsselungsversuche, die von diesen Flüssen abhängen, fehlschlagen, und die Daten können nicht mehr durch sie wiederhergestellt werden.

Was nicht betroffen ist: Die nicht interaktive Verwendung von CryptProtectData und CryptUnprotectData (Übergabe NULL für pPromptStructoder Bereitstellung einer Struktur mit dwPromptFlags set auf 0) ist davon unberührt.

Erforderliche Aktion: Aktualisieren Sie alle Aufrufe von CryptProtectData oder CryptUnprotectData , die einen CRYPTPROTECT_PROMPTSTRUCT Mit CRYPTPROTECT_PROMPT_ON_PROTECT - oder CRYPTPROTECT_PROMPT_ON_UNPROTECT Satz übergeben. Übergeben NULL Sie entweder eine Struktur, dwPromptFlags die pPromptStructauf 0 festgelegt ist, oder übergeben Sie eine Struktur. Es gibt keinen Ersatz für das interaktive Eingabeaufforderungsverhalten selbst.

Syntax

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

Mitglieder

cbSize

Die Größe dieser Struktur in Byte.

dwPromptFlags

DWORD-Flags , die angeben, wann Benutzeraufforderungen angezeigt werden sollen. Aktuelle dwPromptFlags-Werte sind wie folgt.

Wert	Bedeutung
CRYPTPROTECT_PROMPT_ON_PROTECT	Dieses Kennzeichen wird verwendet, um die Aufforderung für die Schutzphase bereitzustellen.
CRYPTPROTECT_PROMPT_ON_UNPROTECT	Dieses Flag kann mit CRYPTPROTECT_PROMPT_ON_PROTECT kombiniert werden, um die Benutzeroberflächenrichtlinie (Benutzeroberfläche) des Aufrufers zu erzwingen. Wenn CryptUnprotectData aufgerufen wird, werden die im CryptProtectData-Aufruf angegebenen dwPromptFlags erzwungen.

hwndApp

Fensterziehpunkt für das übergeordnete Fenster.

szPrompt

Eine Zeichenfolge, die den Text einer Eingabeaufforderung enthält, die angezeigt werden soll.

Anforderungen

Requirement	Wert
Mindestens unterstützter Client	Windows XP [nur Desktop-Apps]
Mindestanforderungen für unterstützte Server	Windows Server 2003 [Nur Desktop-Apps]
Header	dpapi.h

Siehe auch

CryptProtectData

CryptUnprotectData