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

SetValueOnCertificate 메서드는 속성 값을 기존 인증서와 연결합니다.

구문

HRESULT SetValueOnCertificate(
  [in] VARIANT_BOOL MachineContext,
  [in] EncodingType Encoding,
  [in] BSTR         strCertificate
);

[in] MachineContext

인증서 저장소가 로컬 컴퓨터 또는 현재 사용자용인지 여부를 나타내는 VARIANT_BOOL 값입니다. 컴퓨터에 대한 VARIANT_TRUE 지정하고 사용자에 대한 VARIANT_FALSE 지정합니다.

[in] Encoding

strCertificate 매개 변수로 식별된 인증서 문자열에 적용되는 유니코드 인코딩의 형식을 지정하는 EncodingType 열거형 값입니다.

[in] strCertificate

DER로 인코딩된 인증서를 포함하는 BSTR 변수입니다.

Windows 7 및 Windows Server 2008 R2부터는 인코딩된 인증서 대신 인증서 지문 또는 일련 번호를 지정할 수 있습니다. 이렇게 하면 함수가 일치하는 인증서에 대한 적절한 로컬 저장소를 검색합니다. 다음 사항을 주의하세요.

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

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

반환 코드/값	설명
CRYPT_E_NOT_FOUND	인증서를 찾을 수 없습니다.
CRYPT_E_UNEXPECTED_MSG_TYPE	인증서를 찾았지만 프라이빗 키를 로드할 수 없습니다.

InitializeDecode 메서드 또는 InitializeFromCertificate 메서드를 호출하여 속성 값을 만듭니다. 두 메서드를 호출하기 전에 먼저 PropertyId 속성을 설정하여 초기화할 속성 값을 지정해야 합니다.