Share via

IX509PrivateKey::Create 메서드(certenroll.h)

  • 아티클

Create 메서드는 비대칭 프라이빗 키를 만듭니다.

구문

HRESULT Create();

반환 값

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

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

반환 코드/값 설명
HRESULT_FROM_WIN32(ERROR_BUSY)
 CSP 핸들이 NULL이 아닙니다.
HRESULT_FROM_WIN32(ERROR_FILE_EXISTS)
 키가 이미 있습니다.

설명

CspStatus, ProviderName 또는 ProviderType 속성을 설정하지 않으면 이 메서드는 키를 만들 때 기본 공급자, 키 크기 및 KeySpec 값을 사용합니다. 예를 들어 새 운영 체제 설치에서 Microsoft 고급 암호화 공급자 v1.0이 기본 공급자입니다.

ContainerName 속성을 설정하지 않으면 이 메서드는 자동으로 이름을 생성합니다. 생성된 이름에는 GUID가 포함되며 ContainerNamePrefix 속성이 설정되지 않은 경우 "lp-"의 접두사입니다. 공급자가 스마트 카드 공급자인 경우 생성된 이름은 공급자가 지정한 MaxKeyContainerNameLength 값을 초과하지 않습니다. 생성된 이름이 처음에 이 값을 초과하면 40자로 잘립니다.

Create 또는 Open 메서드를 호출한 후에는 다음 속성을 설정할 수 없습니다. 지정하려는 경우 이러한 메서드 중 하나를 호출하기 전에 지정해야 합니다.

요구 사항

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

추가 정보

IX509PrivateKey