CryptSetProviderA 함수(wincrypt.h)

아티클
03/15/2023

중요 이 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