CryptSetProviderExA 함수(wincrypt.h)
구문
BOOL CryptSetProviderExA(
[in] LPCSTR pszProvName,
[in] DWORD dwProvType,
[in] DWORD *pdwReserved,
[in] DWORD dwFlags
);
매개 변수
[in] pszProvName
새 기본 CSP의 이름입니다. 컴퓨터에 설치된 CSP여야 합니다. 사용 가능한 암호화 공급자 목록은 암호화 공급자 이름을 참조하세요.
[in] dwProvType
pszProvName으로 지정된 CSP의 공급자 유형입니다.
[in] pdwReserved
이 매개 변수는 나중에 사용하도록 예약되어 있으며 NULL이어야 합니다.
[in] dwFlags
다음 플래그 값이 정의됩니다.
반환 값
함수가 성공하면 반환 값은 0이 아닌 값(TRUE)입니다.
함수가 실패하면 반환 값은 0(FALSE)입니다. 확장된 오류 정보는 GetLastError를 호출합니다. 가능한 오류 코드에는 다음 표에 나와 있는 오류 코드가 포함됩니다.
반환 코드 | 설명 |
---|---|
|
매개 변수 중 하나에는 유효하지 않은 값이 포함되어 있습니다. 이는 가장 자주 유효하지 않은 포인터입니다. |
|
운영 체제에 메모리가 부족합니다. |
설명
대부분의 애플리케이션은 CryptAcquireContext 함수를 호출할 때 CSP 이름을 지정하지 않습니다. 그러나 애플리케이션은 CSP 이름을 지정하여 적절한 수준의 보안을 가진 CSP를 선택할 수 있습니다. CryptSetProviderEx를 호출하면 해당 시점부터 모든 애플리케이션에서 사용하는 지정된 형식의 CSP가 결정되므로 CryptSetProviderEx는 사용자의 동의 없이는 호출되지 않아야 합니다.
참고
wincrypt.h 헤더는 CRYptSetProviderEx를 유니코드 전처리기 상수의 정의에 따라 이 함수의 ANSI 또는 유니코드 버전을 자동으로 선택하는 별칭으로 정의합니다. 인코딩 중립 별칭을 인코딩 중립이 아닌 코드와 혼합하면 컴파일 또는 런타임 오류가 발생하는 불일치가 발생할 수 있습니다. 자세한 내용은 함수 프로토타입에 대한 규칙을 참조하세요.
요구 사항
지원되는 최소 클라이언트 | Windows XP [데스크톱 앱만 해당] |
지원되는 최소 서버 | Windows Server 2003 [데스크톱 앱만 해당] |
대상 플랫폼 | Windows |
헤더 | wincrypt.h |
라이브러리 | Advapi32.lib |
DLL | Advapi32.dll |