estructura CRYPTPROTECT_PROMPTSTRUCT (dpapi.h)

La estructura CRYPTPROTECT_PROMPTSTRUCT proporciona el texto de un mensaje e información sobre cuándo y dónde se va a mostrar ese mensaje al usar las funciones CryptProtectData y CryptUnprotectData .

Importante

En desuso — fecha de eliminación: abril de 2027. El flujo interactivo de cifrado y descifrado basado en mensajes que proporciona esta estructura (CRYPTPROTECT_PROMPT_ON_PROTECT y CRYPTPROTECT_PROMPT_ON_UNPROTECT) se quitará en abril de 2027. Las aplicaciones que dependen de flujos basados en mensajes deben migrarse antes de esa fecha; después de la eliminación, se producirá un error en los intentos de descifrado que dependen de esos flujos y los datos ya no se podrán recuperar a través de ellos.

Lo que NO se ve afectado: El uso no interactivo de CryptProtectData y CryptUnprotectData (pasando NULL para pPromptStructo proporcionando una estructura con establecida en dwPromptFlags 0) no se ve afectada.

Acción necesaria: Actualice las llamadas a CryptProtectData o CryptUnprotectData que pasen un CRYPTPROTECT_PROMPTSTRUCT con CRYPTPROTECT_PROMPT_ON_PROTECT o CRYPTPROTECT_PROMPT_ON_UNPROTECT establecido. Pase para pPromptStructo pase NULL una estructura con dwPromptFlags establecida en 0. No hay ningún reemplazo para el propio comportamiento del aviso interactivo.

Sintaxis

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

Members

cbSize

Tamaño, en bytes, de esta estructura.

dwPromptFlags

Marcas DWORD que indican cuándo se mostrarán las indicaciones al usuario. Los valores actuales dwPromptFlags son los siguientes.

Value	Meaning
CRYPTPROTECT_PROMPT_ON_PROTECT	Esta marca se usa para proporcionar la solicitud de la fase de protección.
CRYPTPROTECT_PROMPT_ON_UNPROTECT	Esta marca se puede combinar con CRYPTPROTECT_PROMPT_ON_PROTECT para aplicar la directiva de interfaz de usuario (interfaz de usuario) del autor de la llamada. Cuando se llama a CryptUnprotectData , se aplican los dwPromptFlags especificados en la llamada a CryptProtectData .

hwndApp

Identificador de ventana a la ventana primaria.

szPrompt

Cadena que contiene el texto de un mensaje que se va a mostrar.

Requisitos

Requirement	Value
Cliente mínimo compatible	Windows XP [solo aplicaciones de escritorio]
Servidor mínimo admitido	Windows Server 2003 [solo aplicaciones de escritorio]
Header	dpapi.h

Consulte también

CryptProtectData

CryptUnprotectData