ICertProperty::InitializeDecode 메서드(certenroll.h)

InitializeDecode 메서드는 속성 값이 포함된 바이트 배열에서 개체를 초기화합니다. 바이트 배열은 유니코드로 인코딩된 문자열로 표시됩니다.

구문

HRESULT InitializeDecode(
  [in] EncodingType Encoding,
  [in] BSTR         strEncodedData
);

매개 변수

[in] Encoding

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

[in] strEncodedData

DER(Distinguished Encoding Rules) 인코딩된 속성 값을 포함하는 BSTR 변수입니다.

반환 값

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

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

반환 코드/값	설명
HRESULT_FROM_WIN32(ERROR_ALREADY_INITIALIZED)	개체가 이미 초기화되었습니다.

설명

PropertyId 속성을 호출하여 초기화할 속성을 지정합니다. RawData 속성을 호출하여 인코딩된 속성 값을 검색할 수 있습니다. SetValueOnCertificate 메서드를 호출하여 속성 값을 인증서와 연결합니다.

InitializeDecode 메서드가 실패하면 ICertProperty 개체가 초기화되지 않고 입력 속성 값이 저장되지 않습니다. 그러나 PropertyId 속성은 지정된 식별자를 유지합니다.

InitializeDecode 메서드는 특정 인터페이스가 없는 CERTENROLL_PROPERTYID 열거형에서 식별된 사용자 지정 속성 및 속성을 초기화할 수 있도록 제공됩니다. 해당 열거형에서 지원되는 각 값에는 InitializeDecode 메서드에 제공해야 하는 데이터 형식(일반적으로 CRYPT_INTEGER_BLOB)에 대한 정보가 포함됩니다. IBinaryConverter 인터페이스를 사용하여 바이트 배열을 문자열로 변환할 수 있습니다.

다음 인터페이스는 가장 일반적인 속성을 간단하게 만들 수 있습니다.

• ICertPropertyArchived
• ICertPropertyArchivedKeyHash
• ICertPropertyAutoEnroll
• ICertPropertyBackedUp
• ICertPropertyDescription
• ICertPropertyEnrollment
• ICertPropertyFriendlyName
• ICertPropertyKeyProvInfo
• ICertPropertyRenewal
• ICertPropertyRequestOriginator
• ICertPropertySHA1Hash

요구 사항

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

추가 정보

ICertProperties

ICertProperty