Share via

IAlternativeName::InitializeFromString 메서드(certenroll.h)

  • 아티클

InitializeFromString 메서드는 전자 메일 주소, DNS(Domain Name System) 이름, URL, 등록된 개체 식별자(OID) 또는 UPN(사용자 계정 이름)이 포함된 문자열에서 개체를 초기화합니다.

구문

HRESULT InitializeFromString(
  [in] AlternativeNameType Type,
  [in] BSTR                strValue
);

매개 변수

[in] Type

strValue 매개 변수에 포함된 입력 문자열로 표시되는 이름의 형식을 식별하는 AlternativeNameType 열거형 값입니다. 다음 값 중 하나여야 합니다.

값 의미
XCN_CERT_ALT_NAME_RFC822_NAME
 이름은 전자 메일 주소입니다.
XCN_CERT_ALT_NAME_DNS_NAME
 이름은 DNS 이름입니다.
XCN_CERT_ALT_NAME_URL
 이름은 URL입니다.
XCN_CERT_ALT_NAME_REGISTERED_ID
 이름은 등록된 OID입니다.
XCN_CERT_ALT_NAME_USER_PRINCIPLE_NAME
 이름은 UPN입니다.

[in] strValue

이름을 포함하는 BSTR 변수입니다.

반환 값

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

함수가 실패하면 오류를 나타내는 HRESULT 값을 반환합니다. 일반적인 오류 코드 목록은 일반적인 HRESULT 값을 참조하세요.

설명

이 메서드를 사용하여 UPN을 지정하는 경우 UPN은 XCN_OID_NT_PRINCIPAL_NAME(1.3.6.1.4.1.311.20.2.3) OID와 연결되고 Distinguished Encoding Rules(DER)로 인코딩됩니다. RawData 속성을 호출하여 인코딩된 바이트 배열을 검색할 수 있습니다. ObjectId 속성을 호출하여 OID를 검색할 수 있습니다.

이 메서드를 사용하여 다음 이름 형식을 지정하는 경우 메서드는 E_INVALIDARG 반환합니다.

값 설명
XCN_CERT_ALT_NAME_UNKNOWN 이름 형식이 식별되지 않았습니다.
XCN_CERT_ALT_NAME_OTHER_NAME 이름은 OID 및 바이트 배열로 구성됩니다.
XCN_CERT_ALT_NAME_DIRECTORY_NAME 이름은 X.500 디렉터리 이름입니다.
XCN_CERT_ALT_NAME_IP_ADDRESS 이름은 IP 주소입니다.
XCN_CERT_ALT_NAME_GUID 이름은 GUID입니다.
 

InitializeFromOtherName 메서드를 사용하여 OID 및 해당 이름 문자열을 지정할 수 있으며 InitializeFromRawData 메서드를 사용하여 GUID, IP 주소 또는 X.500 디렉터리 이름을 지정할 수 있습니다.

요구 사항

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

추가 정보

IAlternativeName

IAlternativeNames

IX509ExtensionAlternativeNames