다음을 통해 공유


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

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

문법

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

매개 변수

[in] strQualifier

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

[in] Type

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

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

반환 값

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

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

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

비고

Type 매개 변수에서 PolicyQualifierTypeUrl을 지정하는 경우 이 메서드는 strQualifier 매개 변수에 입력한 문자열을 XCN_OID_PKIX_POLICY_QUALIFIER_CPS(1.3.6.1.5.5.5.7.2.1) 개체 식별자(OID)와 연결하고 DER(고유 인코딩 규칙)을 사용하여 인코딩합니다. URL은 ASN.1( Abstract Syntax Notation One ) IA5 문자열로 인코딩됩니다.

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

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

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

요구 사항

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

참고하십시오

IPolicyQualifier