PFN_CRYPT_OBJECT_LOCATOR_PROVIDER_FREE_IDENTIFIER 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_FREE_IDENTIFIER libera memoria para un identificador de objeto.

Sintaxis

PFN_CRYPT_OBJECT_LOCATOR_PROVIDER_FREE_IDENTIFIER PfnCryptObjectLocatorProviderFreeIdentifier;

void PfnCryptObjectLocatorProviderFreeIdentifier(
  [in, optional] LPVOID pPluginContext,
  [in]           PCRYPT_DATA_BLOB pIdentifier
)
{...}

Parámetros

[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.

[in] pIdentifier

Puntero al búfer que contiene el identificador.

Valor devuelto

None

Observaciones

Actualmente, solo el paquete de seguridad del canal seguro (Schannel) llama a la función PFN_CRYPT_OBJECT_LOCATOR_PROVIDER_FREE_IDENTIFIER . Se puede llamar a esta función por cualquiera de los siguientes motivos:

Error al procesar el objeto devuelto por la función PFN_CRYPT_OBJECT_LOCATOR_PROVIDER_GET .
El objeto devuelto por PFN_CRYPT_OBJECT_LOCATOR_PROVIDER_GET ya no es necesario.
Se ha recuperado un objeto actualizado y el objeto original ya no es necesario.

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_GET

PFN_CRYPT_OBJECT_LOCATOR_PROVIDER_INITIALIZE