CryptMsgCountersignEncoded 함수(wincrypt.h)

  • 아티클

CryptMsgCountersignEncoded 함수는 기존 PKCS #7 메시지 서명을 서명합니다. 만드는 pbCountersignatureBYTE 버퍼는 PKCS #9 signed-data 또는 signed-and-enveloped-data 메시지의 인증되지 않은 Countersignature 특성으로 사용할 수 있는 PKCS #7 인코딩 SignerInfo입니다.

구문

BOOL CryptMsgCountersignEncoded(
  [in]      DWORD                    dwEncodingType,
  [in]      PBYTE                    pbSignerInfo,
  [in]      DWORD                    cbSignerInfo,
  [in]      DWORD                    cCountersigners,
  [in]      PCMSG_SIGNER_ENCODE_INFO rgCountersigners,
  [out]     PBYTE                    pbCountersignature,
  [in, out] PDWORD                   pcbCountersignature
);

매개 변수

[in] dwEncodingType

사용되는 인코딩 형식을 지정합니다. 현재는 X509_ASN_ENCODING 및 PKCS_7_ASN_ENCODING만 사용되고 있습니다. 그러나 나중에 추가 인코딩 형식이 추가될 수 있습니다. 현재 인코딩 형식의 경우 다음을 사용합니다.

X509_ASN_ENCODING | PKCS_7_ASN_ENCODING.

[in] pbSignerInfo

카운터 서명할 인코딩된 SignerInfo에 대한 포인터입니다.

[in] cbSignerInfo

인코딩된 SignerInfo 데이터의 개수(바이트)입니다.

[in] cCountersigners

rgCountersigners 배열의 카운터 서명자 수입니다.

[in] rgCountersigners

카운터 서명자의 CMSG_SIGNER_ENCODE_INFO 구조의 배열입니다.

[out] pbCountersignature

인코딩된 PKCS #9 카운터 서명 특성을 수신하는 버퍼에 대한 포인터입니다.

입력 시 이 매개 변수는 메모리 할당을 위해 이 정보의 크기를 설정하는 NULL 일 수 있습니다. 자세한 내용은 알 수 없는 길이의 데이터 검색을 참조하세요.

[in, out] pcbCountersignature

pbCountersignature 매개 변수가 가리키는 버퍼의 크기(바이트)를 지정하는 변수에 대한 포인터입니다. 함수가 반환되면 pcbCountersignature 매개 변수가 가리키는 변수에 버퍼에 저장된 바이트 수가 포함됩니다.

반환 값

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

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

다음 표에서는 GetLastError 함수에서 가장 일반적으로 반환되는 오류 코드를 나열합니다.

반환 코드 설명
CRYPT_E_OID_FORMAT
 개체 식별자의 형식이 잘못되었습니다.
E_INVALIDARG
 하나 이상의 인수가 잘못되었습니다.
E_OUTOFMEMORY
 메모리가 부족합니다.
 

전파된 오류는 다음 함수 중 하나에서 반환될 수 있습니다.

함수가 실패하면 GetLastError 는 추상 구문 표기법 1(ASN.1) 인코딩/디코딩 오류를 반환할 수 있습니다. 이러한 오류에 대한 자세한 내용은 ASN.1 반환 값 인코딩/디코딩을 참조하세요.

요구 사항

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

추가 정보

CryptMsgCountersign

CryptMsgVerifyCountersignatureEncoded

하위 수준 메시지 함수

간소화된 메시지 함수