다음을 통해 공유


IX509NameValuePair 인터페이스(certenroll.h)

IX509NameValuePair 인터페이스는 제네릭 이름-값 쌍을 나타냅니다. 인증서 요청 및 등록 프로세스에서 만든 몇 가지 일반적인 이름-값 쌍이 있지만 이 개체를 사용하여 이름과 값을 지정할 수 있습니다. IX509NameValuePairs 컬렉션은IX509Enrollment 개체 및 IX509CertificateRequestCmc 개체에서 검색할 수 있습니다. 컬렉션은 관련이 없습니다.

name-value 쌍 및 등록 개체:
IX509Enrollment 개체가 CA(인증 기관)에 인증서 요청을 제출하기 전에 name-value 컬렉션은 Name1:Value1\Name2:Value2\형식의 연결된 특성 문자열로 인코딩됩니다. NameValuePairs 속성을 호출하여 컬렉션을 검색할 수 있습니다. IX509NameValuePairs 개체를 사용하여 컬렉션에 이름-값 쌍을 추가할 수 있습니다.
name-value 쌍 및 CMC 요청 개체:
CMC 요청 개체(IX509CertificateRequestCmc)에는 TaggedAttribute, TaggedRequestTaggedContentInfo ASN.1 구조의 시퀀스가 포함됩니다. 자세한 내용은 CMC 특성을 참조하세요.

TaggedAttribute 구조체에는 RegInfo 특성이 포함될 수 있습니다. 이 특성은 이름-값 쌍 컬렉션을 포함하는 바이트 배열로 구성됩니다. 바이트 배열은 다음과 같은 방식으로 만들어집니다.

  • 각 이름-값 문자열은 표준화됩니다. 예를 들어 "%5C" 이스케이프는 백슬래시(\\) 문자로 대체됩니다.
  • 각 이름-값 쌍은 등호(=)를 사용하여 연결됩니다.
  • 모든 쌍은 각 쌍 간에 앰퍼샌드(&)를 사용하여 연결됩니다.
  • 결과는 UTF-8 문자열로 인코딩됩니다.

다음 예제에서는 "RequesterName=Domain\TargetUser"의 단일 이름-값 쌍을 포함하는 RegInfo 특성을 포함하는 CMC 인증서에 대한 ASN.1 출력을 보여 줍니다.


...
30 33              ; SEQUENCE (33 Bytes)
   02 01                            ; INTEGER (1 Bytes)
   |  02
   06 08                            ; OBJECT_ID (8 Bytes)
   |  2b 06 01 05 05 07 07 12
   |     ; 1.3.6.1.5.5.7.7.18 Reg Info
   31 24                ; SET (24 Bytes)
      04 22 ; OCTET_STRING (22 Bytes)
      52 65 71 75 65 73 74 65  72 4e 61 6d 65 3d 44 6f  ; RequesterName=Do
      6d 61 69 6e 25 35 43 54  61 72 67 65 74 55 73 65  ; main%5CTargetUse
      72 26                                             ; r&
...

상속

IX509NameValuePair 인터페이스는 IDispatch 인터페이스에서 상속됩니다. IX509NameValuePair 에는 다음과 같은 유형의 멤버도 있습니다.

메서드

IX509NameValuePair 인터페이스에는 이러한 메서드가 있습니다.

 
IX509NameValuePair::get_Name

이름-값 쌍의 이름 부분을 검색합니다.
IX509NameValuePair::get_Value

이름-값 쌍의 값 부분을 검색합니다.
IX509NameValuePair::Initialize

이름 및 연결된 값을 포함하는 문자열에서 개체를 초기화합니다.

요구 사항

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

추가 정보

CertEnroll 인터페이스

IDispatch

IX509NameValuePairs