PFN_CRYPT_OBJECT_LOCATOR_PROVIDER_FREE Rückruffunktion (wincrypt.h)

Die PFN_CRYPT_OBJECT_LOCATOR_PROVIDER_FREE Rückruffunktion gibt das vom Anbieter zurückgegebene Objekt frei.

Syntax

PFN_CRYPT_OBJECT_LOCATOR_PROVIDER_FREE PfnCryptObjectLocatorProviderFree;

void PfnCryptObjectLocatorProviderFree(
  [in, optional] LPVOID pPluginContext,
  [in]           PBYTE pbData
)
{...}

Parameter

[in, optional] pPluginContext

Zeiger auf einen optionalen Puffer, der von diesem Anbieter definiert und von der PFN_CRYPT_OBJECT_LOCATOR_PROVIDER_INITIALIZE-Funktion 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.

[in] pbData

Zeiger auf den Puffer, der freigegeben werden soll.

Rückgabewert

Keine

Bemerkungen

Die PFN_CRYPT_OBJECT_LOCATOR_PROVIDER_FREE-Funktion wird derzeit nur vom Sicherheitspaket Secure Channel (Schannel) aufgerufen. Schannel ruft PFN_CRYPT_OBJECT_LOCATOR_PROVIDER_GET auf, um ein Objekt abzurufen, und ruft dann PFN_CRYPT_OBJECT_LOCATOR_PROVIDER_FREE auf, um die vom PFN_CRYPT_OBJECT_LOCATOR_PROVIDER_GET Aufruf zurückgegebenen Daten aus dem Arbeitsspeicher zu entfernen, wenn sie nicht mehr benötigt werden.

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_GET

PFN_CRYPT_OBJECT_LOCATOR_PROVIDER_INITIALIZE