CertGetIntendedKeyUsage 함수(wincrypt.h)

CertGetIntendedKeyUsage 함수는 인증서에서 의도한 키 사용 바이트를 획득합니다. 의도한 키 사용은 szOID_KEY_USAGE("2.5.29.15") 또는 szOID_KEY_ATTRIBUTES("2.5.29.2") 확장에 있을 수 있습니다.

구문

BOOL CertGetIntendedKeyUsage(
  [in]  DWORD      dwCertEncodingType,
  [in]  PCERT_INFO pCertInfo,
  [out] BYTE       *pbKeyUsage,
  [in]  DWORD      cbKeyUsage
);

매개 변수

[in] dwCertEncodingType

사용되는 인코딩 형식을 지정합니다. 다음 예제와 같이 비트 OR 작업과 결합하여 인증서 및 메시지 인코딩 형식을 모두 지정할 수 있습니다.

X509_ASN_ENCODING | PKCS_7_ASN_ENCODING 현재 정의된 인코딩 형식은 다음과 같습니다.

• X509_ASN_ENCODING
• PKCS_7_ASN_ENCODING

[in] pCertInfo

지정된 인증서의 CERT_INFO 구조에 대한 포인터입니다.

[out] pbKeyUsage

의도한 키 사용을 수신할 버퍼에 대한 포인터입니다. 다음 목록에는 현재 정의된 값이 나와 있습니다. 비트 OR 연산을 사용하여 결합할 수 있습니다.

• CERT_DATA_ENCIPHERMENT_KEY_USAGE
• CERT_DIGITAL_SIGNATURE_KEY_USAGE
• CERT_KEY_AGREEMENT_KEY_USAGE
• CERT_KEY_CERT_SIGN_KEY_USAGE
• CERT_KEY_ENCIPHERMENT_KEY_USAGE
• CERT_NON_REPUDIATION_KEY_USAGE
• CERT_OFFLINE_CRL_SIGN_KEY_USAGE

[in] cbKeyUsage

pbKeyUsage가 가리키는 버퍼의 크기(바이트)입니다. 현재 의도한 키 사용량은 1바이트 또는 2바이트의 데이터를 차지합니다.

반환 값

인증서에 의도한 키 사용 바이트가 없으면 FALSE 가 반환되고 pbKeyUsage 가 0이 됩니다. 그렇지 않으면 TRUE 가 반환되고 최대 cbKeyUsage 바이트 수가 pbKeyUsage로 복사됩니다. 복사되지 않은 나머지 바이트는 0입니다.

필요한 확장을 찾을 수 없는 경우 GetLastError는 0을 반환합니다.

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

요구 사항

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

추가 정보

데이터 관리 함수