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

InitializeFromRawData 메서드는 DSA(디지털 서명 알고리즘) GUID, X.500 디렉터리 이름 또는 DER(Distinguished Encoding Rules) 인코딩된 바이트 배열에 포함된 IP(인터넷 프로토콜) 주소에서 개체를 초기화합니다.

구문

HRESULT InitializeFromRawData(
  [in] AlternativeNameType Type,
  [in] EncodingType        Encoding,
  [in] BSTR                strRawData
);

매개 변수

[in] Type

입력 문자열이 나타내는 이름의 형식을 식별하는 AlternativeNameType 열거형 값입니다. 다음 값 중 하나여야 합니다.

값	의미
XCN_CERT_ALT_NAME_DIRECTORY_NAME	이름은 X.500 디렉터리 이름입니다.
XCN_CERT_ALT_NAME_IP_ADDRESS	이름은 IP 주소입니다.
XCN_CERT_ALT_NAME_GUID	이름은 GUID입니다.

[in] Encoding

strRawData 매개 변수에 적용된 유니코드 인코딩 유형을 식별하는 EncodingType 열거형 값입니다.

[in] strRawData

DER로 인코딩된 데이터를 포함하는 BSTR 변수입니다.

반환 값

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

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

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

설명

원시 데이터는 DER(Distinguished Encoding Rules)를 사용하여 인코딩된 바이트 배열입니다. 바이트 배열을 유니코드로 인코딩된 문자열로 지정해야 합니다.

이 메서드를 사용하여 DSA GUID(XCN_CERT_ALT_NAME_GUID)를 지정하는 경우 GUID는 XCN_OID_NTDS_REPLICATION(1.3.6.1.4.1.311.25.1) 개체 식별자 (OID)와 연결되고 8진수 문자열(바이트 배열)로 인코딩됩니다. ObjectId 속성을 호출하여 OID를 검색할 수 있습니다. RawData 속성을 호출하여 인코딩된 바이트 배열을 검색할 수 있습니다.

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

값	Description
XCN_CERT_ALT_NAME_UNKNOWN	이름 형식이 식별되지 않았습니다.
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( 사용자 계정 이름 )입니다.
XCN_CERT_ALT_NAME_OTHER_NAME	이름은 OID 및 바이트 배열로 구성됩니다.

 

InitializeFromOtherName 메서드를 사용하여 OID 및 해당 이름 문자열을 지정할 수 있으며 InitializeFromString 메서드를 사용하여 전자 메일 주소, DNS 이름, URL, 등록된 OID 또는 UPN(사용자 계정 이름)을 지정할 수 있습니다.

요구 사항

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

추가 정보

IAlternativeName