CMSG_CTRL_DECRYPT_PARA 구조체(wincrypt.h)

CMSG_CTRL_DECRYPT_PARA 구조에는 키 전송 수신자에 대한 봉투 메시지를 해독하는 데 사용되는 정보가 포함되어 있습니다. dwCtrlType 매개 변수가 CMSG_CTRL_DECRYPT 경우 이 구조체는 CryptMsgControl에 전달됩니다.

CryptoAPI가 S/MIME( Secure/Multipurpose Internet Mail Extensions ) 전자 메일 상호 운용성을 지원하는 방법에 대한 자세한 내용은 CryptMsgOpenToEncode의 설명 섹션을 참조하세요.

구문

typedef struct _CMSG_CTRL_DECRYPT_PARA {
  DWORD cbSize;
  union {
    HCRYPTPROV        hCryptProv;
    NCRYPT_KEY_HANDLE hNCryptKey;
  } DUMMYUNIONNAME;
  DWORD dwKeySpec;
  DWORD dwRecipientIndex;
} CMSG_CTRL_DECRYPT_PARA, *PCMSG_CTRL_DECRYPT_PARA;

멤버

cbSize

이 구조체의 크기(바이트)입니다.

DUMMYUNIONNAME

DUMMYUNIONNAME.hCryptProv

CSP(암호화 서비스 공급자) 핸들입니다. CNG 함수 NCryptIsKeyHandle 은 공용 구조체 선택을 결정하기 위해 호출됩니다.

DUMMYUNIONNAME.hNCryptKey

CNG CSP( 암호화 서비스 공급자 )에 대한 핸들입니다. CNG 함수 인 NCryptIsKeyHandle은 공용 구조체 선택을 결정하기 위해 호출됩니다. 새 암호화 알고리즘은 CNG 함수에서만 지원됩니다. CNG 함수 인 NCryptTranslateHandle은 필요한 경우 CryptoAPI hCryptProv 선택을 변환하기 위해 호출됩니다. 애플리케이션은 NCryptOpenKey 함수에서 반환되는 CNG CSP 핸들인 hNCryptKey 멤버에 전달하는 것이 좋습니다.

dwKeySpec

사용할 프라이빗 키입니다. 이 멤버는 hNCryptKey 멤버를 사용할 때 사용되지 않습니다.

다음 dwKeySpec 값은 기본 공급자에 대해 정의됩니다.

값	의미
AT_KEYEXCHANGE	세션 키를 암호화하고 암호 해독하는 데 사용되는 키입니다.
AT_SIGNATURE	디지털 서명을 만들고 확인하는 데 사용되는 키입니다.

 

dwKeySpec이 0이면 기본 AT_KEYEXCHANGE 사용됩니다.

dwRecipientIndex

hCryptProv 프라이빗 키와 연결된 메시지의 받는 사람 인덱스입니다.

요구 사항

지원되는 최소 클라이언트	Windows XP [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2003 [데스크톱 앱만 해당]
머리글	wincrypt.h

추가 정보

CryptMsgControl