PFN_CMSG_CNG_IMPORT_CONTENT_ENCRYPT_KEY 콜백 함수(wincrypt.h)
PFN_CMSG_CNG_IMPORT_CONTENT_ENCRYPT_KEY 콜백 함수는 이미 암호가 해독된 CEK(콘텐츠 암호화 키)를 가져옵니다. PFN_CMSG_CNG_IMPORT_CONTENT_ENCRYPT_KEY 함수는 Cryptography API: CNG(Next Generation) OID(개체 식별자)를 사용하여 설치할 수 있습니다.
구문
PFN_CMSG_CNG_IMPORT_CONTENT_ENCRYPT_KEY PfnCmsgCngImportContentEncryptKey;
BOOL PfnCmsgCngImportContentEncryptKey(
[in, out] PCMSG_CNG_CONTENT_DECRYPT_INFO pCNGContentDecryptInfo,
[in] DWORD dwFlags,
void *pvReserved
)
{...}
매개 변수
[in, out] pCNGContentDecryptInfo
가져온 CEK로 업데이트할 CMSG_CNG_CONTENT_DECRYPT_INFO 구조체에 대한 포인터입니다. 이 구조체에는 CryptMsgControl 함수에 전달된 모든 관련 정보가 포함됩니다.
[in] dwFlags
이 매개 변수는 예약되어 있습니다. 0으로 설정합니다.
pvReserved
이 매개 변수는 예약되어 있습니다. NULL로 설정합니다.
반환 값
함수가 성공하면 반환 값은 0이 아닌 값(TRUE)입니다.
함수가 실패하면 반환 값은 0(FALSE)입니다. 확장된 오류 정보는 GetLastError를 호출합니다.
이 콜백 함수가 키 암호화 알고리즘을 지원하지 않는 경우 FALSE 를 반환하고 ERROR_NOT_SUPPORTED 사용하여 SetLastError 를 호출해야 합니다.
설명
CryptMsgControl 함수는 dwCtrlType 매개 변수로 지정된 다음 작업에 대해 이 함수를 호출합니다.
- CMSG_CTRL_DECRYPT
- CMSG_CTRL_KEY_TRANS_DECRYPT
- CMSG_CTRL_KEY_AGREE_DECRYPT
OID 지원 함수를 사용하여 이 콜백 함수를 배포할 수 있습니다. Wincrypt.h는 이 목적을 위해 다음 상수를 정의합니다.
상수 | 정의 |
---|---|
CMSG_OID_CNG_IMPORT_CONTENT_ENCRYPT_KEY_FUNC | "CryptMsgDllCNGImportContentEncryptKey" |
예제
OID 설치 가능 콜백 함수를 배포하는 예제는 CryptoAPI 기능 확장을 참조하세요.
요구 사항
요구 사항 | 값 |
---|---|
지원되는 최소 클라이언트 | Windows Vista [데스크톱 앱만 해당] |
지원되는 최소 서버 | Windows Server 2008 [데스크톱 앱만 해당] |
대상 플랫폼 | Windows |
헤더 | wincrypt.h |