IX509ExtensionBasicConstraints::InitializeEncode 메서드(certenroll.h)
InitializeEncode 메서드는 인증서 주체가 CA(인증 기관) 및 하위 CA 체인의 깊이를 포함하는 정수인지 여부를 나타내는 부울 값에서 확장을 초기화합니다.
구문
HRESULT InitializeEncode(
[in] VARIANT_BOOL IsCA,
[in] LONG PathLenConstraint
);
매개 변수
[in] IsCA
인증서 주체가 CA인지 여부를 지정하는 VARIANT_BOOL 변수입니다.
[in] PathLenConstraint
체인의 최대 인증서 수를 포함하는 LONG 변수입니다.
반환 값
함수가 성공하면 함수는 S_OK 반환합니다.
함수가 실패하면 오류를 나타내는 HRESULT 값을 반환합니다. 가능한 값에는 다음 표에 있는 값이 포함되지만, 이에 국한되는 것은 아닙니다. 일반적인 오류 코드 목록은 일반 HRESULT 값을 참조하세요.
| 반환 코드/값 | 설명 |
|---|---|
|
개체가 이미 초기화되었습니다. |
설명
메서드는 이름 컬렉션을 XCN_OID_BASIC_CONSTRAINTS2(2.5.29.19) OID(개체 식별자)와 연결하고 DER(Distinguished Encoding Rules)를 사용하여 인코딩합니다.
IX509ExtensionBasicConstraints 개체를 사용하려면 먼저 InitializeEncode 또는 InitializeDecode를 호출해야 합니다. 두 메서드는 서로를 보완합니다. InitializeEncode 메서드를 사용하면 원시 데이터에서 DER로 인코딩된 ASN.1(Abstract Syntax Notation One) 확장 개체를 생성할 수 있으며 InitializeDecode 메서드를 사용하면 인코딩된 개체에서 원시 데이터를 초기화할 수 있습니다.
이 확장에 대해 다음 속성을 검색할 수 있습니다.
- Critical 속성은 확장이 중요한지 여부를 식별합니다. 이 속성을 지정할 수도 있습니다.
- ObjectId 속성은 OID를 검색합니다.
- IsCA 속성은 인증서 주체가 인증 기관이 될 수 있는지 여부를 식별합니다.
- PathLenConstraint 속성은 하위 인증 기관 체인의 깊이를 식별합니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows Vista [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2008 [데스크톱 앱만 해당] |
| 대상 플랫폼 | Windows |
| 헤더 | certenroll.h |
| DLL | CertEnroll.dll |