다음을 통해 공유


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 속성을 호출하여 인코딩된 이름을 포함하는 문자열을 검색합니다.

요구 사항

   
지원되는 최소 클라이언트 Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버 Windows Server 2008 [데스크톱 앱만 해당]
대상 플랫폼 Windows
헤더 certenroll.h
DLL CertEnroll.dll

추가 정보

IX500DistinguishedName