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 열거형 값입니다. 다음 값 중 하나여야 합니다.
| 값 | 의미 |
|---|---|
|
이름은 X.500 디렉터리 이름입니다. |
|
이름은 IP 주소입니다. |
|
이름은 GUID입니다. |
[in] Encoding
strRawData 매개 변수에 적용된 유니코드 인코딩 유형을 식별하는 EncodingType 열거형 값입니다.
[in] strRawData
DER로 인코딩된 데이터를 포함하는 BSTR 변수입니다.
반환 값
함수가 성공하면 함수는 S_OK 반환합니다.
함수가 실패하면 오류를 나타내는 HRESULT 값을 반환합니다. 가능한 값에는 다음 표에 있는 값이 포함되지만, 이에 국한되는 것은 아닙니다. 일반적인 오류 코드 목록은 일반 HRESULT 값을 참조하세요.
| 반환 코드 | 설명 |
|---|---|
|
개체가 이미 초기화되었습니다. |
설명
원시 데이터는 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 |