PFN_CRYPT_OBJECT_LOCATOR_PROVIDER_RELEASE funzione di callback (wincrypt.h)

Articolo
03/03/2024

La funzione di callback PFN_CRYPT_OBJECT_LOCATOR_PROVIDER_RELEASE rilascia il provider.

Sintassi

PFN_CRYPT_OBJECT_LOCATOR_PROVIDER_RELEASE PfnCryptObjectLocatorProviderRelease;

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

Parametri

[in] dwReason

Specifica il motivo per cui il provider viene rilasciato. I valori possibili sono i seguenti:

Valore	Significato
CRYPT_OBJECT_LOCATOR_RELEASE_SYSTEM_SHUTDOWN 1	Il computer viene arrestato.
CRYPT_OBJECT_LOCATOR_RELEASE_SERVICE_STOP 2	Il servizio è in fase di interruzione.
CRYPT_OBJECT_LOCATOR_RELEASE_PROCESS_EXIT 3	Il processo chiamante termina.
CRYPT_OBJECT_LOCATOR_RELEASE_DLL_UNLOAD 4	La DLL del provider sta scaricando.

[in, optional] pPluginContext

Puntatore a un buffer facoltativo definito da questo provider e restituito dalla funzione PFN_CRYPT_OBJECT_LOCATOR_PROVIDER_INITIALIZE . Il buffer non viene modificato dal chiamante. Il provider può usare i dati per determinare quali azioni eseguire o mantenere informazioni aggiuntive.

Valore restituito

nessuno

Osservazioni

La funzione di callback PFN_CRYPT_OBJECT_LOCATOR_PROVIDER_RELEASE è attualmente chiamata solo dal pacchetto di sicurezza Secure Channel (Schannel). Questa funzione viene chiamata una volta per ogni chiamata effettuata a PFN_CRYPT_OBJECT_LOCATOR_PROVIDER_INITIALIZE.

Il provider non deve rilasciare tutta la memoria per tutti gli oggetti, ma deve essere pulita se il parametro dwReason è impostato su CRYPT_OBJECT_LOCATOR_RELEASE_SERVICE_STOP o CRYPT_OBJECT_LOCATOR_RELEASE_DLL_UNLOAD.

Questa funzione deve bloccare in modo che le chiamate a PFN_CRYPT_OBJECT_LOCATOR_PROVIDER_FLUSH possano essere completate.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 8 [solo app desktop]
Server minimo supportato	Windows Server 2012 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	wincrypt.h

Vedi anche

CRYPT_OBJECT_LOCATOR_PROVIDER_TABLE

PFN_CRYPT_OBJECT_LOCATOR_PROVIDER_INITIALIZE

Condividi tramite