ICertEncodeAltName::SetNameEntry 메서드(certenc.h)

SetNameEntry 메서드는 대체 이름 배열의 지정된 인덱스에서 이름을 설정합니다.

이 메서드를 사용하기 전에 개체가 배열에 있는 요소 수를 알 수 있도록 ICertEncodeAltName::Reset 을 호출해야 합니다.

구문

HRESULT SetNameEntry(
  [in] LONG       NameIndex,
  [in] LONG       NameChoice,
  [in] const BSTR strName
);

[in] NameIndex

설정할 대체 이름 항목의 인덱스를 지정하는 인덱스(0부터 시작)입니다.

NameChoice 매개 변수가 CERT_ALT_NAME_OTHER_NAME 경우 OID를 설정할 EAN_NAMEOBJECTID(0x80000000 정의됨)이 있는 인덱스 값(|)입니다. 그렇지 않으면 이진 값이 설정됩니다.

[in] NameChoice

이름 선택을 지정합니다. 이름 선택은 올바르게 사용할 수 있도록 대체 이름의 형식을 나타냅니다. 다음 값 중 하나여야 합니다.

값	의미
CERT_ALT_NAME_DIRECTORY_NAME	이름은 디렉터리 이름입니다.
CERT_ALT_NAME_DNS_NAME	이름은 host.entity.domain 형식으로 DNS(도메인 이름 시스템) 이름을 지정하는 IA5 문자열입니다.
CERT_ALT_NAME_IP_ADDRESS	이름은 인터넷 프로토콜 주소를 나타내는 8진수 문자열입니다.
CERT_ALT_NAME_REGISTERED_ID	이름은 등록된 OID( 개체 식별자 )입니다.
CERT_ALT_NAME_RFC822_NAME	이름은 전자 메일 주소입니다.
CERT_ALT_NAME_URL	이름은 Service://HostName/ 경로 형식의 URL을 포함하는 IA5 문자열입니다.
CERT_ALT_NAME_OTHER_NAME	이름은 OID( 개체 식별자 ) 및 이진 BLOB으로 구성됩니다.

[in] strName

대체 이름을 지정합니다.

메서드가 성공하면 메서드는 S_OK 반환합니다.

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