CRYPTPROTECT_PROMPTSTRUCT 구조체(dpapi.h)

CRYPTPROTECT_PROMPTSTRUCT 구조체는 CryptProtectData 및 CryptUnprotectData 함수를 사용할 때 프롬프트의 텍스트와 해당 프롬프트가 표시되는 시기와 위치에 대한 정보를 제공합니다.

Important

사용되지 않음 - 제거 날짜: 2027년 4월. 이 구조(CRYPTPROTECT_PROMPT_ON_PROTECT 및)에서 제공하는 대화형 프롬프트 기반 암호화 및 CRYPTPROTECT_PROMPT_ON_UNPROTECT암호 해독 흐름은 2027년 4월에 제거될 예정입니다. 프롬프트 기반 흐름을 사용하는 애플리케이션은 해당 날짜 이전에 마이그레이션해야 합니다. 제거 후 해당 흐름에 의존하는 암호 해독 시도가 실패하고 데이터를 통해 더 이상 복구할 수 없게 됩니다.

영향을 받지 않는 사항:CryptProtectData 및 CryptUnprotectData 의 비대화형 사용(전달 NULLpPromptStruct또는 0으로 dwPromptFlags 설정된 구조체 제공)은 영향을 받지 않습니다.

필요한 작업: With 또는 CRYPTPROTECT_PROMPT_ON_UNPROTECT set를 전달하는 CryptProtectData 또는 CryptUnprotectData에 대한 호출을 CRYPTPROTECT_PROMPTSTRUCTCRYPTPROTECT_PROMPT_ON_PROTECT 업데이트합니다. 0으로 dwPromptFlags 설정된 구조체를 pPromptStruct전달하거나 전달 NULL 합니다. 대화형 프롬프트 동작 자체를 대체할 수 없습니다.

Syntax

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 결합하여 호출자의 UI(사용자 인터페이스) 정책을 적용할 수 있습니다. CryptUnprotectData가 호출되면 CryptProtectData 호출에 지정된 dwPromptFlags가 적용됩니다.

hwndApp

부모 창에 대한 창 핸들입니다.

szPrompt

표시할 프롬프트의 텍스트가 포함된 문자열입니다.

Requirements

Requirement	Value
지원되는 최소 클라이언트	Windows XP [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2003 [데스크톱 앱만 해당]
Header	dpapi.h

또한, 다음을 참조하세요.

CryptProtectData

CryptUnprotectData