estrutura CRYPTPROTECT_PROMPTSTRUCT (dpapi.h)

A estrutura CRYPTPROTECT_PROMPTSTRUCT fornece o texto de um prompt e informações sobre quando e onde esse prompt deve ser exibido ao usar as funções CryptProtectData e CryptUnprotectData .

Importante

Preterido — data da remoção: abril de 2027. O fluxo interativo de criptografia e descriptografia baseado em prompt fornecido por essa estrutura (CRYPTPROTECT_PROMPT_ON_PROTECT e CRYPTPROTECT_PROMPT_ON_UNPROTECT) será removido em abril de 2027. Os aplicativos que dependem de fluxos baseados em prompt devem migrar antes dessa data; após a remoção, as tentativas de descriptografia que dependem desses fluxos falharão e os dados não serão mais recuperáveis por meio deles.

O que NÃO é afetado: O uso não interativo de CryptProtectData e CryptUnprotectData (passando NULL para pPromptStruct, ou fornecendo um struct com dwPromptFlags definido como 0) não é afetado.

Ação necessária: Atualize as chamadas para CryptProtectData ou CryptUnprotectData que passam uma CRYPTPROTECT_PROMPTSTRUCT com CRYPTPROTECT_PROMPT_ON_PROTECT ou CRYPTPROTECT_PROMPT_ON_UNPROTECT definir. NULL Passe para pPromptStruct, ou passe um struct com dwPromptFlags definido como 0. Não há nenhuma substituição para o comportamento de prompt interativo em si.

Sintaxe

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

Members

cbSize

O tamanho, em bytes, dessa estrutura.

dwPromptFlags

Sinalizadores DWORD que indicam quando as solicitações para o usuário devem ser exibidas. Os valores atuais de dwPromptFlags são os seguintes.

Valor	Meaning
CRYPTPROTECT_PROMPT_ON_PROTECT	Esse sinalizador é usado para fornecer o prompt para a fase de proteção.
CRYPTPROTECT_PROMPT_ON_UNPROTECT	Esse sinalizador pode ser combinado com CRYPTPROTECT_PROMPT_ON_PROTECT para impor a política de interface do usuário (interface do usuário) do chamador. Quando CryptUnprotectData é chamado, as dwPromptFlags especificadas na chamada CryptProtectData são impostas.

hwndApp

Identificador de janela para a janela pai.

szPrompt

Uma cadeia de caracteres que contém o texto de um prompt a ser exibido.

Requisitos

Requirement	Valor
Cliente mínimo suportado	Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo compatível	Windows Server 2003 [somente aplicativos da área de trabalho]
Header	dpapi.h

Consulte também

CryptProtectData

CryptUnprotectData