IX500DistinguishedName::Encode 메서드(certenroll.h)

Encode 메서드는 고유 이름을 포함하는 문자열에서 개체를 초기화합니다. 이 메서드는 웹을 사용할 수 있습니다.

구문

HRESULT Encode(
  [in] BSTR          strName,
  [in] X500NameFlags NameFlags
);

[in] strName

인코딩할 문자열을 포함하는 BSTR 변수입니다.

[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	strName 매개 변수는 NULL일 수 없습니다.
HRESULT_FROM_WIN32(ERROR_FILENAME_EXCED_RANGE)	strName 매개 변수의 문자로 된 길이는 64 * 1024를 초과할 수 없습니다.

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