структура CRYPTPROTECT_PROMPTSTRUCT (dpapi.h)

Структура CRYPTPROTECT_PROMPTSTRUCT предоставляет текст запроса и сведения о том, когда и где будет отображаться запрос при использовании функций CryptProtectData и CryptUnprotectData .

Important

Устарело — дата удаления: апрель 2027 г. Интерактивный поток шифрования и расшифровки, предоставляемый этой структурой (CRYPTPROTECT_PROMPT_ON_PROTECT и CRYPTPROTECT_PROMPT_ON_UNPROTECT) будет удален в апреле 2027 года. Приложения, использующие потоки на основе запросов, должны переноситься до этой даты; После удаления попытки расшифровки, зависящие от этих потоков, завершаются сбоем, и данные больше не будут восстановлены через них.

Что не затрагивается: Неинтерактивное использование CryptProtectData и CryptUnprotectData (передача NULL для pPromptStructили предоставление структуры с dwPromptFlags набором 0) не влияет.

Обязательное действие: Обновите все вызовы CryptProtectData или CryptUnprotectData, которые передаются с CRYPTPROTECT_PROMPT_ON_PROTECT помощью или CRYPTPROTECT_PROMPT_ON_UNPROTECT наборомCRYPTPROTECT_PROMPTSTRUCT. Либо передайте NULLpPromptStructструктуру с dwPromptFlags заданным значением 0. Нет замены для самого интерактивного поведения запроса.

Синтаксис

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

Members

cbSize

Размер этой структуры в байтах.

dwPromptFlags

Флаги DWORD, указывающие, когда будут отображаться запросы пользователя. Текущие значения dwPromptFlags приведены следующим образом.

Value	Meaning
CRYPTPROTECT_PROMPT_ON_PROTECT	Этот флаг используется для предоставления запроса на этап защиты.
CRYPTPROTECT_PROMPT_ON_UNPROTECT	Этот флаг можно объединить с CRYPTPROTECT_PROMPT_ON_PROTECT для применения политики пользовательского интерфейса (пользовательского интерфейса) вызывающего объекта. При вызове CryptUnprotectData применяется dwPromptFlags , указанный в вызове CryptProtectData .

hwndApp

Дескриптор окна в родительском окне.

szPrompt

Строка, содержащая текст отображаемого запроса.

Требования

Requirement	Value
Минимальный поддерживаемый клиент	Windows XP [только классические приложения]
минимальный поддерживаемый сервер	Windows Server 2003 [только классические приложения]
Header	dpapi.h

См. также

CryptProtectData

CryptUnprotectData