SslOpenPrivateKey 함수
SslOpenPrivateKey 함수는 프라이빗 키에 대한 핸들을 엽니다.
구문
SECURITY_STATUS WINAPI SslOpenPrivateKey(
_In_ NCRYPT_PROV_HANDLE hSslProvider,
_Out_ NCRYPT_KEY_HANDLE *phPrivateKey,
_In_ PCCERT_CONTEXT pCertContext,
_In_ DWORD dwFlags
);
매개 변수
-
hSslProvider [in]
-
SSL(Secure Sockets Layer protocol) 프로토콜 공급자에 대한 핸들은 instance.
-
phPrivateKey [out]
-
프라이빗 키에 핸들을 쓸 버퍼의 주소입니다.
키 사용을 마쳤으면 SslFreeObject 함수를 호출하여 phPrivateKey를 해제해야 합니다.
-
pCertContext [in]
-
프라이빗 키를 가져올 인증서의 주소입니다.
-
dwFlags [in]
-
이 매개 변수는 나중에 사용하도록 예약되어 있습니다.
반환 값
함수가 성공하면 0을 반환합니다.
함수가 실패하면 0이 아닌 오류 값이 반환됩니다.
가능한 반환 코드에는 다음이 포함되지만 이에 국한되지는 않습니다.
| 반환 코드/값 | 설명 |
|---|---|
|
필요한 버퍼를 할당할 수 있는 메모리가 부족합니다. |
|
hSslProvider 핸들이 잘못되었습니다. |
|
phPrivateKey 또는 pCertContext 매개 변수는 NULL입니다. |
설명
가져온 프라이빗 키는 인증서 내의 퍼블릭/프라이빗 키 쌍의 일부입니다. 이 함수는 pCertContext 매개 변수로 지정된 인증서에서 프라이빗 키를 추출합니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 |
Windows Vista [데스크톱 앱만 해당] |
| 지원되는 최소 서버 |
Windows Server 2008 [데스크톱 앱만 해당] |
| 헤더 |
|
| DLL |
|