다음을 통해 공유

IPolicyQualifier::InitializeEncode 메서드(certenroll.h)

  • 아티클

InitializeEncode 메서드는 문자열에서 개체를 초기화하고 한정자 형식을 식별하는 값을 초기화합니다.

구문

HRESULT InitializeEncode(
  [in] BSTR                strQualifier,
  [in] PolicyQualifierType Type
);

매개 변수

[in] strQualifier

한정자를 포함하는 BSTR 변수입니다.

[in] Type

인증서 정책에 적용된 한정자 유형을 지정하는 PolicyQualifierType 열거형 값입니다. 다음 값 중 하나일 수 있습니다.

값 의미
PolicyQualifierTypeUnknown
 한정자 형식이 지정되지 않았습니다.
PolicyQualifierTypeUrl
 한정자는 인증서가 발급된 정책과 인증서를 사용할 수 있는 목적을 간략하게 설명하기 위해 인증 기관에서 정의한 CPS(인증 사례 문)를 가리키는 URL입니다.
PolicyQualifierTypeUserNotice
 한정자는 인증서를 사용하는 모든 사용자에게 애플리케이션에서 표시할 텍스트 문입니다. 사용자 알림은 인증서의 허용된 사용을 식별합니다.

반환 값

함수가 성공하면 함수는 S_OK 반환합니다.

함수가 실패하면 오류를 나타내는 HRESULT 값을 반환합니다. 가능한 값에는 다음 표에 있는 값이 포함되지만, 이에 국한되는 것은 아닙니다. 일반적인 오류 코드 목록은 일반적인 HRESULT 값을 참조하세요.

반환 코드 설명
HRESULT_FROM_WIN32(ERROR_ALREADY_INITIALIZED)
 개체가 이미 초기화되어 있습니다.

설명

Type 매개 변수에서 PolicyQualifierTypeUrl을 지정하는 경우 이 메서드는 strQualifier 매개 변수에 입력한 문자열을 XCN_OID_PKIX_POLICY_QUALIFIER_CPS(1.3.6.1.5.5.7.2.1) 개체 식별자(OID)와 연결하고 DER(Distinguished Encoding Rules)를 사용하여 인코딩합니다. URL은 ASN.1( 추상 구문 표기법 1) IA5 문자열로 인코딩됩니다.

Type 매개 변수에서 PolicyQualifierTypeUserNotice를 지정하는 경우 이 메서드는 strQualifier 매개 변수에 입력된 문자열을 XCN_OID_PKIX_POLICY_QUALIFIER_USERNOTICE(1.3.6.1.5.5.7.2.2) OID와 연결하고 DER를 사용하여 인코딩합니다.

이 개체에 대해 다음 속성을 검색할 수 있습니다.

  • ObjectId 속성은 한정자가 CPS인지 사용자 알림인지를 식별하는 OID를 검색합니다.
  • Qualifier 속성은 InitializeEncode 메서드의 strQualifier 매개 변수에 지정된 문자열을 검색합니다.
  • RawData 속성은 DER로 인코딩된 한정자를 검색합니다.
  • Type 속성은 한정자 형식을 지정하는 PolicyQualifierType 열거형 값을 검색합니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버 Windows Server 2008 [데스크톱 앱만 해당]
대상 플랫폼 Windows
헤더 certenroll.h
DLL CertEnroll.dll

추가 정보

IPolicyQualifier