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

GetNameChoice 메서드는 대체 이름 배열의 지정된 인덱스에서 이름 선택을 반환합니다.

구문

HRESULT GetNameChoice(
  [in]  LONG NameIndex,
  [out] LONG *pNameChoice
);

[in] NameIndex

대체 이름 항목의 인덱스를 지정합니다. 첫 번째 항목은 인덱스 0입니다.

[out] pNameChoice

이름 선택 지정자를 받는 LONG 에 대한 포인터입니다.

메서드가 성공하면 메서드는 S_OK 반환하고 pNameChoice 매개 변수는 대체 이름의 형식을 나타내는 값을 가리킵니다. 다음 값 중 하나입니다.

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

반환 값은 지정된 인덱스에서 선택한 이름입니다. 이름 선택은 올바르게 사용할 수 있도록 대체 이름의 형식을 나타냅니다. 다음 값 중 하나여야 합니다.

반환 코드	설명
CERT_ALT_NAME_DIRECTORY_NAME	이름은 디렉터리 이름입니다.
CERT_ALT_NAME_DNS_NAME	이름은 호스트 형식의 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으로 구성됩니다.