Функция NCryptEnumStorageProviders (ncrypt.h)

Статья
08/25/2023

Функция NCryptEnumStorageProviders получает имена зарегистрированных поставщиков хранилища ключей.

Синтаксис

SECURITY_STATUS NCryptEnumStorageProviders(
  [out] DWORD              *pdwProviderCount,
  [out] NCryptProviderName **ppProviderList,
  [in]  DWORD              dwFlags
);

Параметры

[out] pdwProviderCount

Адрес DWORD для получения количества элементов в массиве ppProviderList .

[out] ppProviderList

Адрес указателя структуры NCryptProviderName для получения массива имен зарегистрированных поставщиков хранилища ключей. Переменная, на которую указывает параметр pdwProviderCount , получает количество элементов в этом массиве.

Если эта память больше не нужна, освободите ее, передав указатель на функцию NCryptFreeBuffer .

[in] dwFlags

Флаги, изменяющие поведение функции. Это может быть ноль (0) или следующее значение.

Значение	Значение
NCRYPT_SILENT_FLAG	Запрашивает, чтобы поставщик служб ключей (KSP) не отображал пользовательский интерфейс. Если поставщик должен отобразить пользовательский интерфейс для работы, вызов завершается ошибкой и KSP должен задать код ошибки NTE_SILENT_CONTEXT в качестве последней ошибки.

Значение

NCRYPT_SILENT_FLAG

Запрашивает, чтобы поставщик служб ключей (KSP) не отображал пользовательский интерфейс. Если поставщик должен отобразить пользовательский интерфейс для работы, вызов завершается ошибкой и KSP должен задать код ошибки NTE_SILENT_CONTEXT в качестве последней ошибки.

Возвращаемое значение

Возвращает код состояния, указывающий на успешное или неудачное выполнение функции.

Возможные коды возврата включают, помимо прочего, следующие.

Код возврата	Описание
ERROR_SUCCESS	Функция выполнена успешно.
NTE_BAD_FLAGS	Параметр dwFlags содержит недопустимое значение.
NTE_INVALID_PARAMETER	Один или несколько параметров являются недопустимыми.
NTE_NO_MEMORY	Произошел сбой выделения памяти.

Служба не должна вызывать эту функцию из функции StartService. Если служба вызывает эту функцию из функции StartService, может возникнуть взаимоблокировка, и служба может перестать отвечать на запросы.

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista [только классические приложения]
Минимальная версия сервера	Windows Server 2008 [только классические приложения]
Целевая платформа	Windows
Header	ncrypt.h
Библиотека	Ncrypt.lib
DLL	Ncrypt.dll

См. также раздел

NCryptFreeBuffer

Поделиться через