다음을 통해 공유

CryptSetProviderExA 함수(wincrypt.h)

  • 아티클
중요 이 API는 더 이상 사용되지 않습니다. 신규 및 기존 소프트웨어는 암호화 차세대 API를 사용하기 시작해야 합니다. Microsoft는 이후 릴리스에서 이 API를 제거할 수 있습니다.
 
CryptSetProviderEx 함수는 로컬 컴퓨터 또는 현재 사용자에 대해 지정된 공급자 유형의 기본 CSP(암호화 서비스 공급자)를 지정합니다.
참고 일반적인 애플리케이션에서는 이 함수를 사용하지 않습니다. 관리 애플리케이션에서만 사용하기 위한 것입니다.
 

통사론

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

다음 플래그 값이 정의됩니다.

값 의미
CRYPT_DELETE_DEFAULT
0x00000004
 CRYPT_MACHINE_DEFAULT 또는 CRYPT_USER_DEFAULT 함께 사용하여 기본값을 삭제할 수 있습니다.
CRYPT_USER_DEFAULT
0x00000002
 지정된 형식의 사용자 컨텍스트 기본 CSP를 설정하도록 합니다.
CRYPT_MACHINE_DEFAULT
0x00000001
 지정된 형식의 컴퓨터 기본 CSP가 설정되도록 합니다.

반환 값

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

함수가 실패하면 반환 값은 0(false)입니다. 확장 오류 정보는 GetLastError호출합니다. 가능한 오류 코드에는 다음 표에 나와 있는 오류 코드가 포함됩니다.

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

발언

대부분의 애플리케이션은 CryptAcquireContext 함수를 호출할 때 CSP 이름을 지정하지 않습니다. 그러나 애플리케이션은 CSP 이름을 지정하여 적절한 수준의 보안을 갖춘 CSP를 선택할 수 있습니다. CryptSetProviderEx에 대한 호출은 해당 시점부터 모든 애플리케이션에서 사용하는 지정된 형식의 CSP를 확인할 있으므로 사용자의 동의 없이는 CryptSetProviderEx 호출해서는 안 됩니다.

메모

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

요구 사항

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

참고 항목

CryptAcquireContext

CryptSetProvider

서비스 공급자 함수