BCryptEnumProviders 함수(bcrypt.h)

BCryptEnumProviders 함수는 지정된 알고리즘을 지원하는 모든 CNG 공급자를 가져옵니다.

구문

NTSTATUS BCryptEnumProviders(
  [in]  LPCWSTR              pszAlgId,
  [out] ULONG                *pImplCount,
  [out] BCRYPT_PROVIDER_NAME **ppImplList,
  [in]  ULONG                dwFlags
);

매개 변수

[in] pszAlgId

공급자를 가져올 알고리즘을 식별하는 null로 끝나는 유니코드 문자열에 대한 포인터입니다. 미리 정의된 CNG 알고리즘 식별자 또는 다른 알고리즘 식별자 중 하나일 수 있습니다.

[out] pImplCount

ppImplList 배열의 요소 수를 수신하는 ULONG 변수에 대한 포인터입니다.

[out] ppImplList

지정된 알고리즘을 지원하는 공급자 컬렉션을 받을 BCRYPT_PROVIDER_NAME 구조체 배열의 주소입니다. pImplCount 매개 변수는 이 배열의 요소 수를 받습니다. 이 포인터를 BCryptFreeBuffer 함수에 전달하여 더 이상 필요하지 않은 경우 이 메모리를 해제해야 합니다.

[in] dwFlags

이 함수의 동작을 수정하는 플래그 집합입니다. 현재 정의된 플래그가 없으므로 이 매개 변수는 0이어야 합니다.

반환 값

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

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

반환 코드	설명
STATUS_SUCCESS	함수가 성공했습니다.
STATUS_INVALID_PARAMETER	하나 이상의 매개 변수가 유효하지 않습니다.
STATUS_NO_MEMORY	메모리 할당 오류가 발생했습니다.

설명

BCryptEnumProviders는 사용자 모드 또는 커널 모드에서 호출할 수 있습니다. 커널 모드 호출자는 PASSIVE_LEVELIRQL에서 실행되어야 합니다.

요구 사항

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

추가 정보

BCRYPT_PROVIDER_NAME

BCryptFreeBuffer