다음을 통해 공유

CryptSetProviderA 함수(wincrypt.h)

  • 아티클
중요 이 API는 더 이상 사용되지 않습니다. 신규 및 기존 소프트웨어는 암호화 차세대 API를 사용하기 시작해야 합니다. Microsoft는 이후 릴리스에서 이 API를 제거할 수 있습니다.
 
CryptSetProvider 함수는 현재 사용자의 기본 CSP(암호화 서비스 공급자)를 지정합니다.

현재 사용자의 기본 공급자가 설정된 경우 해당 사용자가 CSP 이름이 아닌 dwProvType 공급자 유형을 지정하는 CryptAcquireContext를 호출하여 해당 기본 공급자를 획득합니다.

CryptSetProviderEx이 함수의 향상된 버전도 사용할 수 있습니다.

참고 일반적인 애플리케이션에서는 이 함수를 사용하지 않습니다. 관리 애플리케이션에서만 사용하기 위한 것입니다.
 

통사론

BOOL CryptSetProviderA(
  [in] LPCSTR pszProvName,
  [in] DWORD  dwProvType
);

매개 변수

[in] pszProvName

새 기본 CSP의 이름입니다. 명명된 CSP를 컴퓨터에 설치해야 합니다. 사용 가능한 암호화 공급자 목록은 암호화 공급자 이름참조하세요.

[in] dwProvType

pszProvName지정된 CSP의 공급자 형식입니다.

반환 값

함수가 성공하면 반환 값은 0이 아닌 값(TRUE)입니다.

함수가 실패하면 반환 값은 0(FALSE)입니다. 확장 오류 정보는 GetLastError호출합니다. 다음 표에는 몇 가지 가능한 오류 코드가 나열되어 있습니다.

반환 코드 묘사
ERROR_INVALID_HANDLE
 매개 변수 중 하나는 유효하지 않은 핸들을 지정합니다.
ERROR_INVALID_PARAMETER
 매개 변수 중 하나에 유효하지 않은 값이 포함되어 있습니다. 이는 가장 자주 유효하지 않은 포인터입니다.
ERROR_NOT_ENOUGH_MEMORY
 운영 체제가 작업 중에 메모리가 부족합니다.
 

내부 호출에서 RegCreateKeyEx 및 RegSetValueEx오류도 전파할 수 있습니다.

발언

일반적인 애플리케이션은 CryptAcquireContext를 호출할 때 CSP 이름을 지정하지; 그러나 애플리케이션에는 특정 CSP를 선택하는 옵션이 있습니다. 이렇게 하면 사용자에게 적절한 수준의 보안으로 CSP를 자유롭게 선택할 수 있습니다.

CryptSetProvider 호출하면 해당 시점부터 실행되는 모든 애플리케이션에서 사용하는 지정된 형식의 CSP가 결정되므로 사용자의 동의 없이는 이 함수를 호출해서는 안 됩니다.

메모

wincrypt.h 헤더는 CRYptSetProvider를 유니코드 전처리기 상수의 정의에 따라 이 함수의 ANSI 또는 유니코드 버전을 자동으로 선택하는 별칭으로 정의합니다. 인코딩 중립 별칭을 인코딩 중립이 아닌 코드와 혼합하면 컴파일 또는 런타임 오류가 발생하는 불일치가 발생할 수 있습니다. 자세한 내용은 함수 프로토타입대한 규칙을 참조하세요.

요구 사항

요구 값
지원되는 최소 클라이언트 Windows XP [데스크톱 앱만 해당]
지원되는 최소 서버 Windows Server 2003 [데스크톱 앱만 해당]
대상 플랫폼 Windows
헤더 wincrypt.h
라이브러리 Advapi32.lib
DLL Advapi32.dll

참고 항목

CryptAcquireContext

암호화 공급자 이름

RegCreateKeyEx

RegSetValueEx

서비스 공급자 함수