Функция BCryptQueryProviderRegistration (bcrypt.h)

Статья
02/23/2024

Функция BCryptQueryProviderRegistration извлекает сведения о поставщике CNG.

Синтаксис

NTSTATUS BCryptQueryProviderRegistration(
  [in]      LPCWSTR             pszProvider,
  [in]      ULONG               dwMode,
  [in]      ULONG               dwInterface,
  [in, out] ULONG               *pcbBuffer,
  [in, out] PCRYPT_PROVIDER_REG *ppBuffer
);

Параметры

[in] pszProvider

Указатель на строку Юникода, завершающуюся null, которая содержит имя поставщика для получения сведений.

[in] dwMode

Указывает тип извлекаемой информации. Это может быть одно из следующих значений.

Значение	Значение
CRYPT_ANY	Получение любых сведений о поставщике.
CRYPT_UM	Получение сведений о пользовательском режиме для поставщика.
CRYPT_KM	Получение сведений о режиме ядра для поставщика.
CRYPT_MM	Получение сведений о пользовательском режиме и режиме ядра для поставщика.

[in] dwInterface

Указывает интерфейс, для которого требуется получить сведения. Это может быть одно из следующих значений.

Значение	Значение
BCRYPT_ASYMMETRIC_ENCRYPTION_INTERFACE	Получите интерфейс асимметричного шифрования.
BCRYPT_CIPHER_INTERFACE	Получите интерфейс шифра.
BCRYPT_HASH_INTERFACE	Получите хэш-интерфейс.
NCRYPT_KEY_STORAGE_INTERFACE	Получите интерфейс хранилища ключей.
BCRYPT_RNG_INTERFACE	Получение интерфейса генератора случайных чисел.
NCRYPT_SCHANNEL_INTERFACE	Получите интерфейс Schannel.
BCRYPT_SECRET_AGREEMENT_INTERFACE	Получите интерфейс секретного соглашения.
BCRYPT_SIGNATURE_INTERFACE	Получите интерфейс сигнатуры.

[in, out] pcbBuffer

Указатель на значение ULONG , которое при входе содержит размер буфера, на который указывает параметр ppBuffer , в байтах. При выходе это значение получает либо количество байтов, скопированных в буфер, либо требуемый размер (в байтах) буфера.

Примечание Это общий размер всего буфера в байтах, а не только размер CRYPT_PROVIDER_REG структуры. Буфер должен содержать другие данные для поставщиков в дополнение к структуре CRYPT_PROVIDER_REG .

[in, out] ppBuffer

Указатель на указатель буфера, который получает структуру CRYPT_PROVIDER_REG и другие данные, описывающие поставщика.

Если этот параметр имеет значение NULL, эта функция вернет STATUS_BUFFER_TOO_SMALL и поместит в значение, указанное параметром pcbBuffer , требуемый размер всех данных в байтах.

Если этот параметр является адресом указателя NULL , эта функция выделяет необходимую память, заполняет ее сведениями о поставщике и помещет указатель на эту память в этом параметре. Завершив использование этой памяти, освободите ее, передав указатель на функцию BCryptFreeBuffer .

Если этот параметр является адресом указателя, отличного от NULL , эта функция будет копировать сведения о поставщике в этот буфер. Параметр pcbBuffer должен содержать размер всего буфера в байтах. Если буфер недостаточно велик для хранения всех сведений о поставщике, эта функция вернет STATUS_BUFFER_TOO_SMALL.

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

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

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

Код возврата	Описание
STATUS_SUCCESS	Функция выполнена успешно.
STATUS_INVALID_PARAMETER	Один или несколько параметров являются недопустимыми.
STATUS_BUFFER_TOO_SMALL	Размер, заданный параметром pcbBuffer , недостаточно велик для хранения всех данных.
STATUS_NOT_FOUND	Не удалось найти поставщиков, соответствующих указанным критериям.

Требования

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

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

BCryptFreeBuffer

CRYPT_PROVIDER_REG

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