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 |