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

  • Статья

Функция обратного вызова 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