중요
이 API는 더 이상 사용되지 않습니다. Microsoft는 향후 릴리스에서 이 API를 제거할 수 있습니다.
GetCryptProvFromCert 함수는 CSP(암호화 서비스 공급자)에 대한 핸들과 인증서 컨텍스트에 대한 키 사양을 가져옵니다. 이 함수를 사용하여 인증서 발급자의 프라이빗 키 에 액세스할 수 있습니다.
참고
이 함수에는 연결된 헤더 파일 또는 가져오기 라이브러리가 없습니다. 이 함수를 호출하려면 사용자 정의 헤더 파일을 만들고 LoadLibrary 및 GetProcAddress 함수를 사용하여 Mssign32.dll 동적으로 연결해야 합니다.
구문
BOOL WINAPI GetCryptProvFromCert(
_In_ HWND hwnd,
_In_ PCCERT_CONTEXT pCert,
_Out_ HCRYPTPROV *phCryptProv,
_Out_ DWORD *pdwKeySpec,
_In_ BOOL *pfDidCryptAcquire,
_Out_opt_ LPWSTR *ppwszTmpContainer,
_Out_opt_ LPWSTR *ppwszProviderName,
_Out_ DWORD *pdwProviderType
);
매개 변수
-
hwnd [in]
-
표시되는 대화 상자의 소유자로 사용할 창의 핸들입니다. 이 멤버는 현재 사용되지 않으며 무시됩니다. 이 매개 변수에 대해 NULL 을 전달하는 것이 안전합니다.
-
pCert [in]
-
인증서의 CERT_CONTEXT 구조에 대한 포인터입니다.
-
phCryptProv [out]
-
CSP에 대한 핸들인 HCRYPTPROV 구조체에 대한 포인터입니다.
-
pdwKeySpec [out]
-
검색할 프라이빗 키의 사양입니다. 가능한 값에는 AT_KEYEXCHANGE 또는 AT_SIGNATURE 포함할 수 있습니다.
-
pfDidCryptAcquire [in]
-
함수가 인증서를 기반으로 공급자 핸들을 획득했는지 여부를 지정하는 값입니다.
-
ppwszTmpContainer [out, optional]
-
임시 키 컨테이너 이름에 대한 null로 끝나는 문자열에 대한 포인터의 주소입니다. GetCryptProvFromCert 함수는 임시 컨테이너를 제공하고 초기화합니다. GetCryptProvFromCert를 호출할 때 주소는 NULL 값을 가리킵니다.
-
ppwszProviderName [out, optional]
-
공급자 이름에 대한 null로 끝나는 문자열에 대한 포인터의 주소입니다. GetCryptProvFromCert 함수는 공급자 이름을 반환합니다. GetCryptProvFromCert를 호출할 때 주소는 NULL 값을 가리킵니다.
-
pdwProviderType [out]
-
CSP 형식을 지정합니다. 0 또는 암호화 공급자 유형 중 하나일 수 있습니다. 이 멤버가 0이면 키 컨테이너는 CNG 키 스토리지 공급자 중 하나입니다.
반환 값
성공하면 이 함수는 TRUE를 반환 합니다. GetCryptProvFromCert 함수는 실패하면 FALSE를 반환합니다.
설명
MakeCert 도구는 -is 명령줄 옵션을 사용하여 호출할 때 GetCryptProvFromCert를 호출합니다.
pfDidCryptAcquire 매개 변수가 TRUE로 설정된 경우 함수는 phCryptProv, pdwKeySpec 및 pdwProviderType 매개 변수를 공급자 값으로 설정합니다.
CSP 사용을 마쳤으면 FreeCryptProvFromCert 함수를 호출하여 해제합니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 |
Windows XP [데스크톱 앱만 해당] |
| 지원되는 최소 서버 |
Windows Server 2003 [데스크톱 앱만 해당] |
| DLL |
|