IX500DistinguishedName::D ecode 메서드(certenroll.h)

Decode 메서드는 유니코드로 인코딩된 고유 이름에서 개체를 초기화합니다.

구문

HRESULT Decode(
  [in] BSTR          strEncodedName,
  [in] EncodingType  Encoding,
  [in] X500NameFlags NameFlags
);

[in] strEncodedName

인코딩된 이름을 포함하는 BSTR 변수입니다.

[in] Encoding

입력 문자열에 적용된 유니코드 인코딩의 형식을 지정하는 EncodingType 열거형 값입니다. 기본값은 XCN_CRYPT_STRING_BASE64.

[in] NameFlags

디코딩된 문자열의 형식을 지정하는 X500NameFlags 열거형 값입니다.

참고 다음 플래그가 자동으로 설정됩니다.

Certenroll.h에 지정된 기본값은 XCN_CERT_NAME_STR_NONE.
XCN_CERT_NAME_STR_FORWARD_FLAG 지정하지 않으면 XCN_CERT_NAME_STR_REVERSE_FLAG 자동으로 적용됩니다.
XCN_CERT_NAME_STR_DISABLE_UTF8_DIR_STR_FLAG 지정하지 않으면 XCN_CERT_NAME_STR_FORCE_UTF8_DIR_STR_FLAG 자동으로 적용됩니다.
XCN_CERT_NAME_STR_ENABLE_PUNYCODE_FLAG 지정한 다른 플래그에 관계없이 자동으로 설정됩니다.

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

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

반환 코드/값	설명
E_OUTOFMEMORY	디코딩된 값에 메모리를 할당할 수 없습니다.
E_POINTER	strEncodedName 매개 변수는 NULL일 수 없습니다.
HRESULT_FROM_WIN32(ERROR_FILE_NOT_FOUND)	이름을 디코딩할 수 없습니다.

이 메서드는 내부적으로 CryptoAPI CertNameToStr 함수를 호출합니다. Name 속성을 호출하여 이름을 null로 끝나는 문자열로 검색합니다. EncodedName 속성을 호출하여 인코딩된 이름을 포함하는 문자열을 검색합니다.