функция обратного вызова PFN_CRYPT_OBJECT_LOCATOR_PROVIDER_RELEASE (wincrypt.h)

Статья
08/27/2023

Функция обратного вызова PFN_CRYPT_OBJECT_LOCATOR_PROVIDER_RELEASE освобождает поставщика.

Синтаксис

PFN_CRYPT_OBJECT_LOCATOR_PROVIDER_RELEASE PfnCryptObjectLocatorProviderRelease;

void PfnCryptObjectLocatorProviderRelease(
  [in]           DWORD dwReason,
  [in, optional] LPVOID pPluginContext
)
{...}

Параметры

[in] dwReason

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

Значение	Значение
CRYPT_OBJECT_LOCATOR_RELEASE_SYSTEM_SHUTDOWN 1	Компьютер завершает работу.
CRYPT_OBJECT_LOCATOR_RELEASE_SERVICE_STOP 2	Служба останавливается.
CRYPT_OBJECT_LOCATOR_RELEASE_PROCESS_EXIT 3	Процесс вызова завершается.
CRYPT_OBJECT_LOCATOR_RELEASE_DLL_UNLOAD 4	Библиотека DLL поставщика выгружается.

[in, optional] pPluginContext

Указатель на необязательный буфер, определенный этим поставщиком и возвращаемый функцией PFN_CRYPT_OBJECT_LOCATOR_PROVIDER_INITIALIZE . Вызывающий объект не изменяется буфером. Ваш поставщик может использовать эти данные, чтобы определить, какие действия следует выполнить или сохранить дополнительную информацию.

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

None

Remarks

Функция обратного вызова PFN_CRYPT_OBJECT_LOCATOR_PROVIDER_RELEASE в настоящее время вызывается только пакетом безопасности Secure Channel (Schannel). Эта функция вызывается один раз для каждого вызова PFN_CRYPT_OBJECT_LOCATOR_PROVIDER_INITIALIZE.

Поставщик не должен освобождать всю память для всех объектов, но должен очистить себя, если параметру dwReasonзадано значение CRYPT_OBJECT_LOCATOR_RELEASE_SERVICE_STOP или CRYPT_OBJECT_LOCATOR_RELEASE_DLL_UNLOAD.

Эта функция должна блокироваться, чтобы вызовы PFN_CRYPT_OBJECT_LOCATOR_PROVIDER_FLUSH могли завершиться.

Требования

Требование	Значение
Минимальная версия клиента	Windows 8 [только классические приложения]
Минимальная версия сервера	Windows Server 2012 [только классические приложения]
Целевая платформа	Windows
Header	wincrypt.h

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

CRYPT_OBJECT_LOCATOR_PROVIDER_TABLE

PFN_CRYPT_OBJECT_LOCATOR_PROVIDER_INITIALIZE

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