PFN_CRYPT_OBJECT_LOCATOR_PROVIDER_RELEASE fonction de rappel (wincrypt.h)

  • Article

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