PFN_CRYPT_OBJECT_LOCATOR_PROVIDER_RELEASE fonction de rappel (wincrypt.h)

Article
08/27/2023

La fonction de rappel PFN_CRYPT_OBJECT_LOCATOR_PROVIDER_RELEASE libère le fournisseur.

Syntaxe

PFN_CRYPT_OBJECT_LOCATOR_PROVIDER_RELEASE PfnCryptObjectLocatorProviderRelease;

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

Paramètres

[in] dwReason

Spécifie la raison pour laquelle le fournisseur est libéré. Il peut s’agir de l’une des valeurs suivantes :

Valeur	Signification
CRYPT_OBJECT_LOCATOR_RELEASE_SYSTEM_SHUTDOWN 1	L’ordinateur s’arrête.
CRYPT_OBJECT_LOCATOR_RELEASE_SERVICE_STOP 2	Le service est en cours d'arrêt.
CRYPT_OBJECT_LOCATOR_RELEASE_PROCESS_EXIT 3	Le processus d’appel se termine.
CRYPT_OBJECT_LOCATOR_RELEASE_DLL_UNLOAD 4	La DLL du fournisseur est en cours de déchargement.

[in, optional] pPluginContext

Pointeur vers une mémoire tampon facultative définie par ce fournisseur et retournée par la fonction PFN_CRYPT_OBJECT_LOCATOR_PROVIDER_INITIALIZE . La mémoire tampon n’est pas modifiée par l’appelant. Votre fournisseur peut utiliser les données pour l’aider à déterminer les actions à effectuer ou à conserver des informations supplémentaires.

Valeur de retour

None

Remarques

La fonction de rappel PFN_CRYPT_OBJECT_LOCATOR_PROVIDER_RELEASE est actuellement appelée uniquement par le package de sécurité Schannel (Secure Channel). Cette fonction est appelée une fois pour chaque appel effectué à PFN_CRYPT_OBJECT_LOCATOR_PROVIDER_INITIALIZE.

Le fournisseur n’est pas censé libérer toute la mémoire pour tous les objets, mais doit propre lui-même si le paramètre dwReason est défini sur CRYPT_OBJECT_LOCATOR_RELEASE_SERVICE_STOP ou CRYPT_OBJECT_LOCATOR_RELEASE_DLL_UNLOAD.

Cette fonction doit être bloquée afin que les appels à PFN_CRYPT_OBJECT_LOCATOR_PROVIDER_FLUSH puissent se terminer.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 8 [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2012 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	wincrypt.h

Voir aussi

CRYPT_OBJECT_LOCATOR_PROVIDER_TABLE

PFN_CRYPT_OBJECT_LOCATOR_PROVIDER_INITIALIZE

Partager via