PFN_CRYPT_OBJECT_LOCATOR_PROVIDER_RELEASE Rückruffunktion (wincrypt.h)

Die PFN_CRYPT_OBJECT_LOCATOR_PROVIDER_RELEASE Rückruffunktion gibt den Anbieter frei.

Syntax

PFN_CRYPT_OBJECT_LOCATOR_PROVIDER_RELEASE PfnCryptObjectLocatorProviderRelease;

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

Parameter

[in] dwReason

Gibt den Grund an, warum der Anbieter freigegeben wird. Mögliche Werte:

Wert	Bedeutung
CRYPT_OBJECT_LOCATOR_RELEASE_SYSTEM_SHUTDOWN 1	Der Computer wird heruntergefahren.
CRYPT_OBJECT_LOCATOR_RELEASE_SERVICE_STOP 2	Der Dienst wird beendet.
CRYPT_OBJECT_LOCATOR_RELEASE_PROCESS_EXIT 3	Der Aufrufprozess wird beendet.
CRYPT_OBJECT_LOCATOR_RELEASE_DLL_UNLOAD 4	Die Anbieter-DLL wird entladen.

[in, optional] pPluginContext

Zeiger auf einen optionalen Puffer, der von diesem Anbieter definiert und von der funktion PFN_CRYPT_OBJECT_LOCATOR_PROVIDER_INITIALIZE zurückgegeben wird. Der Puffer wird vom Aufrufer nicht geändert. Ihr Anbieter kann die Daten verwenden, um zu bestimmen, welche Aktionen ausgeführt werden sollen, oder um zusätzliche Informationen zu verwalten.

Rückgabewert

Keine

Bemerkungen

Die PFN_CRYPT_OBJECT_LOCATOR_PROVIDER_RELEASE Rückruffunktion wird derzeit nur vom Sicherheitspaket Secure Channel (Schannel) aufgerufen. Diese Funktion wird einmal für jeden Aufruf von PFN_CRYPT_OBJECT_LOCATOR_PROVIDER_INITIALIZE aufgerufen.

Es wird nicht erwartet, dass der Anbieter den gesamten Arbeitsspeicher für alle Objekte freigibt, sondern sich selbst sauber, wenn der dwReason-Parameter auf CRYPT_OBJECT_LOCATOR_RELEASE_SERVICE_STOP oder CRYPT_OBJECT_LOCATOR_RELEASE_DLL_UNLOAD festgelegt ist.

Diese Funktion muss blockiert werden, damit Aufrufe von PFN_CRYPT_OBJECT_LOCATOR_PROVIDER_FLUSH abgeschlossen werden können.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 8 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2012 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	wincrypt.h

Weitere Informationen

CRYPT_OBJECT_LOCATOR_PROVIDER_TABLE

PFN_CRYPT_OBJECT_LOCATOR_PROVIDER_INITIALIZE