IX509ExtensionAlternativeNames 인터페이스(certenroll.h)

IX509ExtensionAlternativeNames 인터페이스를 사용하면 인증서의 주체에 대해 하나 이상의 대체 이름 양식을 지정할 수 있습니다. 인증 기관은 인증된 공개 키에 이름을 바인딩하여 확장을 처리합니다. 다음 구문에서는 확장의 ASN.1( 추상 구문 표기법 1) 구조를 보여 줍니다. 확장 값은 DISTINGUISHED ENCODING RULES(DER)를 사용하여 인코딩되고 인증서 요청에 포함됩니다.


----------------------------------------------------------------------
-- AlternativeNames 
-- XCN_OID_SUBJECT_ALT_NAME2 (2.5.29.17)
----------------------------------------------------------------------

AltNames ::= SEQUENCE --#public-- OF GeneralName
GeneralNames ::= AltNames

GeneralName ::= CHOICE 
{
   otherName               [0] IMPLICIT OtherName,
   rfc822Name              [1] IMPLICIT IA5STRING,
   dNSName                 [2] IMPLICIT IA5STRING,
   x400Address             [3] IMPLICIT SeqOfAny,       -- Not supported
   directoryName           [4] EXPLICIT ANY,    
   ediPartyName            [5] IMPLICIT SeqOfAny,
   uniformResourceLocator  [6] IMPLICIT IA5STRING,
   iPAddress               [7] IMPLICIT OCTETSTRING,
   registeredID            [8] IMPLICIT EncodedObjectID -- Not supported
}

OtherName ::= SEQUENCE 
{
   type                    EncodedObjectID,
   value                   [0] EXPLICIT NOCOPYANY 
}

IAlternativeNames 컬렉션을 사용하여 이 확장을 초기화하는 경우 다음 이름 유형이 지원됩니다.

설명
XCN_CERT_ALT_NAME_OTHER_NAME 이름은 개체 식별자와 이름을 포함하는 바이트 배열로 구성됩니다.
XCN_CERT_ALT_NAME_RFC822_NAME 이름은 전자 메일 주소입니다.
XCN_CERT_ALT_NAME_DNS_NAME 이름은 도메인 이름 시스템 이름입니다.
XCN_CERT_ALT_NAME_DIRECTORY_NAME 이름은 X.500 디렉터리 이름입니다.
XCN_CERT_ALT_NAME_URL 이름은 URL입니다.
XCN_CERT_ALT_NAME_IP_ADDRESS 이름은 IP(인터넷 프로토콜) 주소입니다.
XCN_CERT_ALT_NAME_REGISTERED_ID 이름은 등록된 OID( 개체 식별자 )입니다.
XCN_CERT_ALT_NAME_GUID 이름은 GUID입니다. 이는 otherName의 한 형태입니다.
XCN_CERT_ALT_NAME_USER_PRINCIPLE_NAME 이름은 UPN( 사용자 계정 이름 )입니다. UPN 형식은 RFC 822를 기반으로합니다.
 

이 확장 개체를 PKCS #10 요청 또는 CMC 요청에 추가하려면 먼저 IX509Extensions 컬렉션에 추가하고 컬렉션을 사용하여 IX509AttributeExtensions 개체를 초기화해야 합니다. 자세한 내용은 PKCS #10 확장CMC 확장 항목을 참조하세요.

상속

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

메서드

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

 
IX509ExtensionAlternativeNames::get_AlternativeNames

주체 대체 이름의 컬렉션을 검색합니다.
IX509ExtensionAlternativeNames::InitializeDecode

확장 값을 포함하는 Distinguished Encoding Rules(DER) 인코딩된 바이트 배열에서 확장을 초기화합니다. (IX509ExtensionAlternativeNames.InitializeDecode)
IX509ExtensionAlternativeNames::InitializeEncode

IAlternativeNames 컬렉션에서 확장을 초기화합니다.

요구 사항

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

참고 항목

인증서 등록 API

확장

IX509Extension