PFN_CRYPT_OBJECT_LOCATOR_PROVIDER_RELEASE función de devolución de llamada (wincrypt.h)

Artículo
03/03/2024

La función de devolución de llamada PFN_CRYPT_OBJECT_LOCATOR_PROVIDER_RELEASE libera el proveedor.

Sintaxis

PFN_CRYPT_OBJECT_LOCATOR_PROVIDER_RELEASE PfnCryptObjectLocatorProviderRelease;

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

Parámetros

[in] dwReason

Especifica el motivo por el que se libera el proveedor. Puede ser uno de los siguientes valores:

Valor	Significado
CRYPT_OBJECT_LOCATOR_RELEASE_SYSTEM_SHUTDOWN 1	El equipo se está apagando.
CRYPT_OBJECT_LOCATOR_RELEASE_SERVICE_STOP 2	El servicio está deteniéndose.
CRYPT_OBJECT_LOCATOR_RELEASE_PROCESS_EXIT 3	El proceso de llamada finaliza.
CRYPT_OBJECT_LOCATOR_RELEASE_DLL_UNLOAD 4	El archivo DLL del proveedor se descarga.

[in, optional] pPluginContext

Puntero a un búfer opcional definido por este proveedor y devuelto por la función PFN_CRYPT_OBJECT_LOCATOR_PROVIDER_INITIALIZE . El autor de la llamada no modifica el búfer. El proveedor puede usar los datos para ayudarle a determinar qué acciones realizar o mantener información adicional.

Valor devuelto

None

Observaciones

Actualmente, solo el paquete de seguridad del canal seguro (Schannel) llama a la función de devolución de llamada PFN_CRYPT_OBJECT_LOCATOR_PROVIDER_RELEASE . Se llama a esta función una vez para cada llamada realizada a PFN_CRYPT_OBJECT_LOCATOR_PROVIDER_INITIALIZE.

No se espera que el proveedor libere toda la memoria de todos los objetos, pero debe limpiarse si el parámetro dwReason está establecido en CRYPT_OBJECT_LOCATOR_RELEASE_SERVICE_STOP o CRYPT_OBJECT_LOCATOR_RELEASE_DLL_UNLOAD.

Esta función debe bloquearse para que las llamadas a PFN_CRYPT_OBJECT_LOCATOR_PROVIDER_FLUSH puedan completarse.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 8 [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2012 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	wincrypt.h

Consulte también

CRYPT_OBJECT_LOCATOR_PROVIDER_TABLE

PFN_CRYPT_OBJECT_LOCATOR_PROVIDER_INITIALIZE