Condividi tramite


PFN_CRYPT_OBJECT_LOCATOR_PROVIDER_RELEASE funzione di callback (wincrypt.h)

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