ICspInformation::InitializeFromType 메서드(certenroll.h)

InitializeFromType 메서드는 기본 암호화 공급자에서 개체를 초기화합니다.

문법

HRESULT InitializeFromType(
  [in]           X509ProviderType Type,
  [in, optional] IObjectId        *pAlgorithm,
  [in]           VARIANT_BOOL     MachineContext
);

매개 변수

[in] Type

공급자 형식을 정의하는 X509ProviderType 열거형 값입니다.

• XCN_PROV_NONE 지정하고 pAlgorithm 매개 변수를 NULL 이외의 값으로 설정하면 기본 Cryptography API: CNG(Next Generation) 공급자가 사용됩니다.
• XCN_PROV_NONE 이외의 값을 지정하고 pAlgorithm 매개 변수를 NULL로 설정하면 기본 레거시 CSP(암호화 서비스 공급자)가 사용됩니다.

[in, optional] pAlgorithm

알고리즘 OID를 나타내는 IObjectId 인터페이스에 대한 포인터입니다. 이 매개 변수는 선택 사항이며 NULL 수 있습니다. 자세한 내용은 Type 매개 변수를 참조하세요.

[in] MachineContext

컴퓨터 또는 사용자 컨텍스트를 사용하여 지정된 공급자 유형의 기본 공급자를 결정할지 여부를 나타내는 VARIANT_BOOL 변수입니다. 컴퓨터에 대한 VARIANT_TRUE 지정하고 사용자에 대한 VARIANT_FALSE 지정합니다.

반환 값

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

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

비고

InitializeFromType 메서드는 지정된 형식의 유효성을 검사하여 Type 속성에 저장하고, 기본 공급자를 검색하고, ICspInformation 개체에서 다음 속성 값을 설정합니다.

• CspAlgorithms
• HasHardwareRandomNumberGenerator
• IsHardwareDevice
• IsRemovable
• IsSmartCard
• IsSoftwareDevice
• KeySpec
• LegacyCsp
• MaxKeyContainerNameLength
• 이름
• 유효한
• 버전

이 메서드는 CspAlgorithms 속성에서 반환된 ICspAlgorithms 컬렉션에 사용 가능한 알고리즘 을 추가합니다 . InitializeFromName 메서드를 호출하여 CSP 이름에서 개체를 초기화합니다.

요구 사항

참고하십시오

iCspInformation