다음을 통해 공유

CryptMsgGetAndVerifySigner 함수(wincrypt.h)

  • 아티클

CryptMsgGetAndVerifySigner 함수는 암호화 메시지의 서명을 확인합니다.

구문

BOOL CryptMsgGetAndVerifySigner(
  [in]                HCRYPTMSG      hCryptMsg,
  [in]                DWORD          cSignerStore,
  [in, optional]      HCERTSTORE     *rghSignerStore,
  [in]                DWORD          dwFlags,
  [out, optional]     PCCERT_CONTEXT *ppSigner,
  [in, out, optional] DWORD          *pdwSignerIndex
);

매개 변수

[in] hCryptMsg

암호화 메시지의 핸들입니다.

[in] cSignerStore

rghSignerStore 배열의 저장소 수입니다.

[in, optional] rghSignerStore

서명자의 인증서를 검색할 수 있는 인증서 저장소 핸들의 배열입니다.

[in] dwFlags

함수의 특정 사용을 나타냅니다.

값 의미
CMSG_TRUSTED_SIGNER_FLAG
 rghSignerStore의 저장소는 신뢰할 수 있는 것으로 간주되며 서명자의 발급자 및 일련 번호에 해당하는 인증서를 찾기 위해 검색된 유일한 저장소입니다. 그렇지 않으면 서명자 저장소를 제공하여 메시지의 인증서 저장소를 보완할 수 있습니다. 서명자 인증서가 발견되면 해당 공개 키를 사용하여 메시지 서명을 확인합니다.
CMSG_SIGNER_ONLY_FLAG
 서명 확인을 수행하지 않고 서명자를 반환합니다.
CMSG_USE_SIGNER_INDEX_FLAG
 *pdwSignerIndex 에서 지정한 서명자만 반환됩니다. 그렇지 않으면 서명이 확인되거나 서명자가 더 이상 없을 때까지 모든 서명자를 반복합니다.

[out, optional] ppSigner

서명이 확인되면 서명자의 인증서 컨텍스트를 가리키도록 ppSigner가 업데이트됩니다. 인증서 사용을 마쳤으면 CertFreeCertificateContext 함수를 호출하여 컨텍스트를 해제합니다. 애플리케이션에 서명자의 인증서가 필요하지 않은 경우 이 매개 변수는 NULL 일 수 있습니다.

[in, out, optional] pdwSignerIndex

서명이 확인되면 pdwSigner 가 서명자 배열에 있는 서명자의 인덱스를 가리키도록 업데이트됩니다. 애플리케이션에 서명자의 인덱스가 필요하지 않은 경우 이 매개 변수는 NULL 일 수 있습니다.

반환 값

함수가 성공하면 반환 값은 0이 아닌 값(TRUE)입니다.

함수가 실패하면 반환 값은 0(FALSE)입니다. 확장 오류 정보는 GetLastError를 호출합니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows XP [데스크톱 앱 | UWP 앱]
지원되는 최소 서버 Windows Server 2003 [데스크톱 앱 | UWP 앱]
대상 플랫폼 Windows
헤더 wincrypt.h
라이브러리 Crypt32.lib
DLL Crypt32.dll

추가 정보

CERT_CONTEXT

CTL_CONTEXT

CryptMsgControl

CryptMsgOpenToDecode

CTL을 사용하는 확인 함수