NCryptOpenStorageProvider 함수(ncrypt.h)

NCryptOpenStorageProvider 함수는 CNG 키 스토리지 공급자를 로드하고 초기화합니다.

구문

SECURITY_STATUS NCryptOpenStorageProvider(
  [out]          NCRYPT_PROV_HANDLE *phProvider,
  [in, optional] LPCWSTR            pszProviderName,
  [in]           DWORD              dwFlags
);

매개 변수

[out] phProvider

공급자 핸들을 수신하는 NCRYPT_PROV_HANDLE 변수에 대한 포인터입니다. 이 핸들 사용을 마쳤으면 NCryptFreeObject 함수에 전달하여 해제합니다.

[in, optional] pszProviderName

로드할 키 스토리지 공급자를 식별하는 null로 끝나는 유니코드 문자열에 대한 포인터입니다. 키 스토리지 공급자의 등록된 별칭입니다. 이 매개 변수는 선택 사항이며 NULL일 수 있습니다. 이 매개 변수가 NULL이면 기본 키 스토리지 공급자가 로드됩니다. 다음 값은 기본 제공 키 스토리지 공급자를 식별합니다.

값	의미
MS_KEY_STORAGE_PROVIDER L"Microsoft 소프트웨어 키 스토리지 공급자"	Microsoft에서 제공하는 소프트웨어 키 스토리지 공급자를 식별합니다.
MS_SMART_CARD_KEY_STORAGE_PROVIDER L"Microsoft 스마트 카드 키 스토리지 공급자"	Microsoft에서 제공하는 스마트 카드 키 스토리지 공급자를 식별합니다.
MS_PLATFORM_CRYPTO_PROVIDER L"Microsoft Platform Crypto Provider"	Microsoft에서 제공하는 TPM 키 스토리지 공급자를 식별합니다.

[in] dwFlags

함수의 동작을 수정하는 플래그입니다. 이 함수에 대해 정의된 플래그가 없습니다.

반환 값

함수의 성공 또는 실패를 나타내는 상태 코드를 반환합니다.

가능한 반환 코드에는 다음이 포함되지만 이에 국한되지는 않습니다.

반환 코드	설명
ERROR_SUCCESS	함수가 성공했습니다.
NTE_BAD_FLAGS	dwFlags 매개 변수에는 지원되지 않는 하나 이상의 플래그가 포함되어 있습니다.
NTE_INVALID_PARAMETER	하나 이상의 매개 변수가 유효하지 않습니다.
NTE_NO_MEMORY	메모리 할당 오류가 발생했습니다.

설명

오류 조건이 반환되는 경우 공급자는 메모리에서 언로드됩니다. 오류 오류가 반환된 후에는 공급자 내의 함수를 호출해서는 안 됩니다.

서비스에서 StartService 함수에서 이 함수를 호출해서는 안됩니다. 서비스에서 StartService 함수에서 이 함수를 호출하면 교착 상태가 발생하고 서비스가 응답하지 않을 수 있습니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows Vista [데스크톱 앱 | UWP 앱]
지원되는 최소 서버	Windows Server 2008 [데스크톱 앱 | UWP 앱]
대상 플랫폼	Windows
헤더	ncrypt.h
라이브러리	Ncrypt.lib
DLL	Ncrypt.dll